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MANUAL PURPOSE AND STRUCTURE 


Windows Users 


The documentation explains and describes how to use the TriCore 
toolchain to program a TriCore DSP. The documentation is primarily aimed 
at Windows users. You can use the tools either with the graphical 
Embedded Development Environment (EDE) or from the command line in 
a command prompt window. 


Unix Users 


For UNIX the toolchain works the same as it works for the Windows 
command line. 


Directory paths are specified in the Windows way, with back slashes as in 
\ctc\bin. Simply replace the back slashes by forward slashes for use 
with UNIX: /ctc/bin. 


Structure 


The TriCore documentation consists of a User’s Manual which includes a 
Getting Started section and a separate Reference Manual (this manual). 


First you need to install the software. This is described in Chapter 1, 
Software Installation and Configuration, of the User’s Manual. 


After installation you are ready to follow the Getting Started in Chapter 2 
of the User’s Manual. 


Next, move on with the other chapters in the User’s Manual which explain 
how to use the compiler, assembler, linker and the various utilities. 


Once you are familiar with these tools, you can use the Reference Manual 
to lookup specific options and details to make fully use of the TriCore 
toolchain. 
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SHORT TABLE OF CONTENTS 


Chapter 1: TriCore C Language 


Contains overviews of all language extensions: 


Data types 
Keywords 
Function qualifiers 
Intrinsic functions 
Pragmas 
Predefined macros 


Chapter 2: Libraries 


Contains overviews of all library functions you can use in your C source. 
The libraries are implemented according to the ISO/IEC 9899:1999(E) 
standard. 


Chapter 3: TriCore Assembly Language 


Contains an overview of all assembly functions that you can use in your 
assembly source code. 


Chapter 4: Run-time Environment 


Contains a description of the C startup code and explains stack and heap 
usage and floating-point arithmetic. 


Chapter 5: Tool Options 


Contains a description of all tool options: 


Compiler options 
Assembler options 
Linker options 

Control program options 
Make utility options 
Archiver options 


Chapter 6: List File Formats 


Contains a description of the following list file formats: 


Assembler List File Format 
Linker Map File Format 
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Chapter 7: Object File Formats 
Contains a description of the following object file formats: 
e ELF/DWARF Object Formats 
e Motorola S-Record Format 
e Intel Hex Record Format 


Chapter 8: Linker Script Language 


Contains a description of the linker script language (LSL). 


Chapter 9: CPU Functional Problems 


Contains a description of the TASKING TriCore toolchain software 
solutions for functional problems and deviations from the electrical 
specifications and timing specifications for some TriCore derivatives. 


Chapter 10: MISRA-C Rules 


Contains a description the supported and unsupported MISRA-C code 
checking rules. 
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CONVENTIONS USED IN THIS MANUAL 


Notation for syntax 
The following notation is used to describe the syntax of command line 
input: 
bold Type this part of the syntax literally. 
italics Substitute the italic word by an instance. For example: 
filename 
Type the name of a file in place of the word filename. 
{} Encloses a list from which you must choose an item. 
[] Encloses items that are optional. For example 
ctc[-?] 
Both ctc and cte —? are valid commands. 
Separates items in a list. Read it as OR. 
You can repeat the preceding item zero or more times. 
sr You can repeat the preceding item zero or more times, 
separating each item with a comma. 
Example 


ctc [option]... filename 


You can read this line as follows: enter the command ctc with or without 
an option, follow this by zero or more options and specify a filename. The 
following input lines are all valid: 


ctc test.c 
ctc -g test.c 
ctc -g -E test.c 


Not valid is: 
ctc -g 


According to the syntax description, you have to specify a filename. 
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Icons 


The following illustrations are used in this manual: 


& Note: notes give you extra information. 


Warning: read the information carefully. It prevents you from making 
serious mistakes or from loosing information. 


This illustration indicates actions you can perform with the mouse. Such as 
' EDE menu entries and dialogs. 


Ee] Command line: type your input on the command line. 


d> Reference: follow this reference to find related topics. 
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e CA Reference Manual (fifth edition) by Samual P. Harbison and Guy L. 
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Ritchie [1988, Prentice Hall] 
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TriCore C Language 


1.1. INTRODUCTION 


The TASKING TriCore C compiler fully supports the ANSI C standard but 
adds possibilities to program the special functions of the TriCore. 


This chapter contains complete overviews of the following C language 
extensions of the TASKING TriCore C compiler: 

e Data types 

* Keywords 

e Function qualifiers 

e Intrinsic functions 

e Pragmas 


e Predefined macros 
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1.2 DATA TYPES 


The TASKING TriCore C compiler ctc supports the following data types: 
Size | Align 
Type Keyword (bit) (bit) Ranges 
Bit _ bit 8 8 Oor1 
Boolean _Bool 8 8 Oor1 
Character | char 
: 8 8 =2 27-1 
signed char 
unsigned char 8 8 0... 28-1 
Integral short 
915 y: 
signed short 42 16 a. 
unsigned short 16 16 o.. 2164 
int 
signed int 
i 32 16 -281 | 231-1 
ong 
signed long 
unsigned int 
l 32 16 0... 232-1 
unsigned long 
enum 8 8 -27 .. 27-1 
16 16 -215 | 2154 
32 -231 |, 2314 
long long 
signed 64 32 -263 |, -263-41 
long long 
peta 64 32 O.. 264_4 
ong long 
Pointer pointer to data 
| 32 32 0 .. 232-1 
pointer to func 
Floating- -3.402e98 .. -1.175e-38 
Point Rae se 18 1.175e798 ., 3.402638 
double -1.797e308 |, -2,2250-308 
long double an 32 2.225e7308  1,797e308 
Fract __sfract 16 16 [-1, 1> 
_ fract 32 32 [-1, 1> 
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Size | Align 
Type Keyword (bit) (bit) Ranges 
Accum __laccum 64 64 [-131072,131072> 
Packed packb 
a3 »_97 7_ 
signed.. packs 32 16 4x: -2/ .. 2/-1 
unsigned _ packb 32 16 4x: 0 .. 28-1 
packhw 
— » 915 15- 
sioned s packhw 32 16 2x: -2'9 ., 219-1 
pagegned 32 16 2x: 0 ., 216-4 
__ packhw ute 


Table 1-1: Data Types 
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1.3. KEYWORDS 


__a0, _ a1, _ aS, _ a9 
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The data object is located in a section that is addressable with a 
sign-extended 16-bit offset from address register AO, Al, A8 or A9 


respectively. 


__asm() 


With the __ asm() keyword you can use assembly instructions in the C 
source and pass C variables as operands to the assembly code. 


_ asm( “instruction template”" 
[ : output param list 


[ 


instruction t1emplate 


%parm_nr|.regnum| 


output_param_list 


input_param_list 


& 


constraint _char 


C_expression 


register_save_list 


regisier name 


[ : input param list 
: register save list]]] ); 


Assembly instructions that may contain 
parameters from the input list or output list in 
the form: %parm_nr |.regnum| 


Parameter number in the range 0 .. 9. With the 
optional .regnum you can access an individual 
register from a register pair or register quad. For 
example, with register pair d0/d1, .0 selects 
register do. 


[[ ’=[&]constraint_char”(C_expression)],...| 
[| ”constraint_char”(C_expression)|,...] 


Says that an output operand is written to before 
the inputs are read, so this output must not be 
the same register as any input. 


Constraint character: the type of register to be 
used for the C_expression. 


Any C expression. For output parameters it must 
be an lvalue, that is, something that is legal to 
have on the left side of an assignment. 


[[Pregister_name”,...| 


Name of the register you want to reserve. 
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Constraint | Type Operand | Remark 

character 

a Address register a0..a15 

d Data register dO..d15 

e Data register pair e0 .. e7 

m Memory variable Stack or memory operand 

number Type of operand it | same as Indicates that %number and 
is associated with | %number | number are the same register. 


Table 1-2: Available input/output operand constraints 


d> For more information on __ asm, see section 3.6, Using Assembly in the C 
Source, in Chapter TriCore C Language of the User's Manual. 


—atO 


With the attribute __ at () you can place an object at an absolute address. 


int myvar _ at(0x100); 


_ atbit() 


If you have defined a 32-bits base variable (int, long) you can declare a 


single bit of that variable as a bit variable with the keyword __ atbit(). 


The syntax is: 


__ atbit( name, offset ) 


name is the name of an integer variable in which the bit is located. offset 
(range 0-31) is the bit—offset within the variable. 


_ circ 


The TriCore C compiler supports the __ circ keyword for circular buffers. 


d> For more information see section 3.4.1, Circular Buffers, in Chapter 
TriCore C Language of the User’s Manual. 
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_ near 


_ far 


With keyword __ near the declared data object will be located in the first 
16 kB of a 256 MB block. These parts of memory are directly addressable 
with the absolute addressing mode. 


With keyword __ far the data object can be located anywhere in the 
indirect addressable memory region. 


__sfrbit16 
__ Sfrbit52 


db 


With the data type qualifiers ___sfrbit16 and __ sfrbit32 you can 
declare bit fields in special function registers. These keywords force 16-bit 
or 32-bit access. 


For more information see section 3.4.2, Declare an SFR Bit Field: _ sfrbit16 
and _ sfrbit32, in Chapter TriCore C Language of the User’s Manual. 
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1.4 FUNCTION QUALIFIERS 


__enable_ 
__bisr_() 


During the execution of an interrupt service routine or trap service routine, 
the system blocks the CPU from taking further interrupt reguests. You can 
immediately re-enable the system to accept interrupt requests: 


_ interrupt(vector) _ enable_ isr( void ) 
__trap(class) _ enable_ tsr( void ) 


The function qualifier __bisr_() also re-enables the system to accept 
interrupt requests. In addition, the current CPU priority number (CCPN) in 
the interrupt control register is set: 


_ interrupt(vector) _ bisr (CCPN) isr( void ) 
_ trap(class) _ bisr_(CCPN) tsr( void ) 


d> For more information see section 3.9.2, Interrupt and Trap Functions, in 
Chapter 777Core C Language of the User's Manual. 


_ indirect 


Functions are default called with a single word direct call. However, when 
you link the application and the target address appears to be out of reach 
(+/- 16 MB from the callg or jg instruction), the linker generates an 
error. In this case you can use the __ indirect keyword to force the less 
efficient, two and a half word indirect call to the function: 


int _ indirect foo( void ) 
{ 


} 
inline 
__noinline 
You can use the inline qualifier to tell the compiler to inline the function 


body instead of calling the function. Use the __ noinline qualifier to tell 
the compiler not to inline the function body. 
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inline int funcl( void ) 


{ 
// inline this function 
} 
_ noinline int func2( void ) 
{ 
// do not inline this function 
} 


d> For more information see section 3.9.1, Jnlining Functions: inline, in 
Chapter 777Core C Language of the User's Manual. 


_ interrupt) 
_ interrupt_fast() 


You can use the qualifier _ interrupt() to declare a function as an 
interrupt service routine. 


void _ interrupt(vector number) isr(void) 
{ 


} 


The vector_number identifies the entry into the interrupt vector table 
(0..255). Unlike other interrupt systems, the priority number (PIPN) of the 
interrupt now being serviced by the CPU identifies the entry into the 
vector table. 


When you define an interrupt service routine with the 
_ interrupt fast() qualifier, the interrupt handler is directly placed in 
the interrupt vector table, thereby eliminating the jump code. 


d> For more information see section 3.9.2, Interrupt and Trap Functions, in 
Chapter 777Core C Language of the User’s Manual. 


_trapO 


__trap_fastQ 
__ syscallfunc() 


The definition of a trap service routine is similar to the definition of an 
interrupt service routine. Trap functions cannot accept arguments and do 
not return anything: 
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db 


void _ trap( class ) tsr( void ) 


{ 


} 


The argument class identifies the entry into the trap vector table. TriCore 
defines eight classes of trap functions. Each class has its own trap handler. 


When you define a trap service routine with the__ trap fast() 
gualifier, the trap handler is directly placed in the trap vector table, 
thereby eliminating the jump code. 


A special kind of trap service routine is the system call trap. With a system 
call the trap service routine of class 6 is called. For the system call trap, the 
trap identification number (TIN) is taken from the immediate constant 
specified with the function qualifier _ syscallfunc(): 


_ syscallfunc(TIN) 


The TIN is a value in the range 0 and 255. You can only use 

_ syscallfunc() in the function declaration. A function body is useless, 
because when you call the function declared with _ syscallfunc(), a 
trap class 6 occurs which calls the corresponding trap service routine. 


For more information see section 3.9.2, Interrupt and Trap Functions, in 
Chapter 777Core C Language of the User's Manudl. 


__stackparm 


The function gualifier __ stackparm changes the standard calling 
convention of a function into a convention where all function arguments 
are passed via the stack, conforming a so called stack model. This gualifier 
is only needed for situations where you need to use an indirect call to a 
function for which you do not have a valid prototype. 


void _ stackparm stack func ( int ); 
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1.5 INTRINSIC FUNCTIONS 


The TASKING TriCore C compiler recognizes intrinsic functions that serve 
the following purposes: 


Minimum and maximum of (short) integers 
Fractional data type support 

Packed data type support 

Interrupt handling 

Insert single assembly instruction 

Register handling 

Insert / extract bit-fields and bits 
Miscellaneous 


All intrinsic functions begin with a double underscore character (__). You 
can use intrinsic functions as if they were ordinary C functions. 
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1.5.1_ MINIUM AND MAXIMUM OF (SHORT) INTEGERS 


The next table provides an overview of the intrinsic functions that return 
the minium or maximum of a signed integer, unsigned integer or short 


integer. 
Intrinsic Function Description 
int _ min( int,int ) Return minimum of two 
integers 
short _ mins( short,short ) Return minimum of two 
short integers 
unsigned int Return minimum of two 
_ minu( unsigned int, unsigned int ) | unsigned integers 
int _ max( int,int ) Return maximum of two 
integers 
short _ maxs( short,short ) Return maximum of two 
short integers 
unsigned int Return maximum of two 
_ maxu( unsigned int, unsigned int ) | unsigned integers 


Table 1-3: Intrinsic Functions for obtaining min/max values 
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1.5.2 FRACTIONAL ARITHMETIC SUPPORT 


The next table provides an overview of intrinsic functions to convert 
fractional values. Note that the TASKING TriCore C compiler fully supports 
the fractional type so normally you should not need these intrinsic 
functions (except for _ mulfractlong). For compatibility reasons the 
TASKING TriCore C compiler does support these functions. 


Conversion of Fractional Values 


Intrinsic Function Description 
long Integer part of __ fract x long 
_ mulfractlong( _ fract,long ) 
_ sfract Convert _ fract to __ sfract 
_ roundl6( _ fract ) 
_ fract Convert __ accum to __ fract 
_ getfract( _ accum ) 
short Count the consecutive 
__clssf( _ sfract ) number of bits that have the 
same value as bit 15 of an 
__ sfract 
__sfract Left/right shift of an __ sfract 
__shasfracts( _ sfract,int ) 
_ fract Left/right shift of an __ fract 
_ shafracts( _ fract,int ) 
__laccum Left/right shift of an __ Iaccum 
_ Shaaccum( _ laccum,int ) 


Table 1-4: Intrinsic Functions for Conversion of Fractional Values 
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1.5.3 PACKED DATA TYPE SUPPORT 


The next table provides an overview of the intrinsic functions for 


initialization of packed data type. 


Initialize Packed Data Types 


Intrinsic Function 


Description 


packb _ initpackbl( long ) 


packb _ initpackb( int,int,int,int ) 


unsigned packb _ initupackb( 
unsigned,unsigned,unsigned,unsigned) 


packhw _ initpackhwl( long ) 


packhw _ initpackhw( short,short ) 


unsigned packhw _ initupackhw( 
unsigned short,unsigned short) 


Initalize __ packb with a 
long integer 


Initalize __ packb with four 
integers 


Idem, but unsigned 


Initalize __ packhw with a 
long integer 


Initalize __ packhw with two 
integers 


Idem, but unsigned 


Table 1-5: Intrinsic Functions to Initialize Packed Data Types 


Extract Values from Packed Data Types 


The next table provides an overview of the intrinsic functions to extract a 
single byte or halfword from a __ packb or __ packhw data type. 


Intrinsic Function Description 


unsigned char _ extractubytel( 
_ unsigned packb ) 


unsigned char _ extractubyte2( 
_ unsigned packb ) 


unsigned char _ extractubyte3( 
_ unsigned packb ) 


unsigned char _ extractubyte4( 
_ unsigned packb ) 


char _ extractbytel( _ packb ) | Extract first byte from a___ packb 
Idem, but unsigned 

char _ extractbyte2( _ packb ) | Extract second byte from a ___ packb 
Idem, but unsigned 

char _ extractbyte3( _ packb ) | Extract third byte from a __ packb 
Idem, but unsigned 

char _ extractbyte4( _ packb ) | Extract fourth byte from a __ packb 


Idem, but unsigned 
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Intrinsic Function 


Description 


short _ extracthwl( packhw ) 


unsigned short _ extractuhwlf( 


unsigned _ packhw ) 


short _ extracthw2( packhw ) 


unsigned short _ extractuhw2( 


unsigned _ packhw ) 


Extract first short from a __ packhw 
Idem, but unsigned 
Extract second short from a __ packhw 


Idem, but unsigned 


char _ getbytel( _ packb * ) 


unsigned char _ getubytel( 


unsigned _ packb * ) 


char _ getbyte2( _ packb * 


unsigned char _ getubyte2( 


unsigned _ packb * ) 


char _ getbyte3( _ packb * 


unsigned char _ getubyte3( 


unsigned _ packb * ) 


char _ getbyte4( _ packb * 


unsigned char _ getubyte4( 


unsigned _ packb * ) 


short _ gethwl( _ packhw * 


unsigned short _ getuhwl( 


unsigned _ packhw * ) 


short _ gethw2( _ packhw * 


unsigned short _ getuhw2( 


unsigned _ packhw * 


) 


Extract first byte from a __ packb 
Idem, but unsigned 

Extract second byte from a __ packb 
Idem, but unsigned 

Extract third byte from a __ packb 
Idem, but unsigned 

Extract fourth byte from a __ packb 
Idem, but unsigned 

Extract first integer from a __ packhw 
Idem, but unsigned 

Extract short integer from a __ packhw 


Idem, but unsigned 


Table 1-6: Intrinsic Functions to Extract Values from Packed Data Types 
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Insert Values into Packed Data Types 


The next table provides an overview of the intrinsic functions to insert a 
single byte or halfword into a __ packb or __ packhw data type. 


Intrinsic Function Description 


Insert char into first byte of 


packb _ insertbytel( _ packb, char ) a__packb 


unsigned packb _ insertubytel( 


unsigned _ packb, unsigned char ) Idem, but unsigned 


Insert char into second byte 


ackb insertbyte2 ackb, char 
=P =< yte2( _p ) of a __ packb 


unsigned packb _ insertubyte2( 


unsigned _ packb, unsigned char ) Idem, but unsigned 


Insert char into third byte of 


kb i tbyte3 kb, ch 
packb _ insertbyte3( _ pac char ) a__packb 


unsigned packb _ insertubyte3( 


unsigned _ packb, unsigned char ) Idem, but unsigned 


Insert char into fourth byte 


packb _ insertbyte4( _ packb, char ) of a _ packb 


unsigned packb _ insertubyte4( 


unsigned _ packb, unsigned char ) Idem, but unsigned 


Insert short into first 


packhw _ inserthwl( packhw, short ) halfword of a packhw 


unsigned packhw _ insertuhwl( 


unsigned _ packhw, unsigned short ) Idem, but unsigned 


Insert short into second 


packhw _ inserthw2( packhw, short ) halfword of a packhw 


unsigned packhw _ insertuhw2( 


unsigned _ packhw, unsigned short ) Idem, but unsigned 


Insert first byte into a 


void _ setbytel( _ packb *, char ) packb 


void _ setubytel( unsigned _ packb *, 


unsigned Char) Idem, but unsigned 


Insert second byte into a 


void _ setbyte2( _ packb *, char ) packb 


void _ setubyte2( unsigned _ packb *, 


unbagned char) Idem, but unsigned 
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Intrinsic Function Description 


Insert third byte into a 


void _ setbyte3( _ packb *, char ) packb 


void _ setubyte3( unsigned _ packb *, 


unsigned char j Idem, but unsigned 


Insert fourth byte into a 


void _ setbyte4( _ packb *, char ) packb 


void _ setubyte4( unsigned _ packb *, 


unsigned char | Idem, but unsigned 


Insert first integer into a 


void _ sethwl( _ packhw *, short ) packhw 


void _ setuhwl( unsigned _ packhw *, 


Wnaigned short | Idem, but unsigned 


Insert short integer into a 


void _ sethw2( _ packhw *, short ) _ packhw 


void _ setuhw2( unsigned _ packhw *, 


wneigned short j Idem, but unsigned 


Table 1-7: Intrinsic Functions to Insert Values into Packed Data Types 


Combine Packed Data Types into a Packed Word 


The next table provides an overview of the intrinsic functions to combine 
the value of packed data types into a packed word. You can combine two 
__ packb (2 x 4 bytes) into a long long or two __ packhw (2 x 2 
halfwords) into a long long. 


The packed word is a double register that is represented by the additional 
datatype __ packw. To access the values in a _ packw variable, you can use 
a union data type: typedef double _ packw. 


& These intrinsics are only supported for the TriCore2 (—-is-tricore2). 


Intrinsic Function Description 

unsigned long long Combine two __ packb 
__transpose byte( packb,_ packb ) 

unsigned long long Combine two __ packhw 
__transpose hword( _ packhw,_ packhw ) 


Table 1-8: Intrinsic Functions to Combine Packed Data Types 
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Calculate Absolute Values of Packed Data Type Values 


The next table provides an overview of the intrinsic functions to calculate 
the absolute value of packed data type values. 


Intrinsic Function Description 
packb _ absb( _ packb ) Absolute value of __ packb 
_ packhw _ absh( _ packhw ) Absolute value of __ packhw 
__sat _ packhw Absolute value of __ packhw 
_ abssh( _ sat _ packhw ) using saturation 


Table 1-9: Intrinsic Functions to Calculate Absolute Values 


Calculate Minimum Packed Data Type Values 


The next table provides an overview of the intrinsic functions to calculate 
the minimum from two packed data type values. 


Intrinsic Function Description 
packb _ minb( packb,_ packb ) Minimum of two __ packb 
values 
unsigned _ packb _ minbu( unsigned Minimum of two unsigned 
__packb, unsigned _ packb ) packb values 
packhw _ minh( _ packhw,_ packhw ) | Minimum of two __ packhw 
values 
unsigned _ packhw _ minhu( unsigned Minimum of two unsigned 
packhw, unsigned _ packhw ) packhw values 


Table 1-10: Imtrinsic Functions to Calculate Absolute Values 


1.5.4 INTERRUPT HANDLING 


The next table provides an overview of the intrinsic functions to read or 
set interrupt handling:. 
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Intrinsic Function 


Description 


void _ enable ( void ) 


void _ disable ( void ) 


int _ disable and save ( void ) 


void _ restore ( int ) 


Enable interrupts immediately at 
function entry 


Disable interrupts Only supported 
for TriCore1. 


Disable interrupts and return 
previous interrupt state (enabled or 
disabled). Only supported for 
TriCore2 (—-is-tricore2). 


Restore interrupt state. Only 
supported for TriCore2 
(—-is-tricore2). 


void _ bisr ( int ) 


void _ syscall ( int ) 


Set CPU priority number [0..512] 
and enable interrupts immediately 
at function entry 


Call a system call function number 


Table 1-11: Intrinsic Functions for Interrupt Handling 
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1.5.5 


INSERT SINGLE ASSEMBLY INSTRUCTION 


The next table provides an overview of the intrinsic functions that you can 


use to insert a single assembly instruction. 


You can also use inline assembly but these intrinsics provide a shorthand 


for freguently used assembly instructions. 


See section 3.6, Using Assembly in tbe C Source: _ asm() of the 


User's Manual 


Intrinsic Function 


Description 


void 
void 
void 
void 
void 


void 


_ debug( void 
_ dsync( void 
_ isync( void 
_ SVlcx( void 
_ rslcx( void 


_ nop( void ) 


Insert DEBUG instruction 
Insert DSYNC instruction 
Insert ISYNC instruction 

Insert SVLOX instruction 
Insert RSLCX instruction 
Insert NOP instruction 


Table 1-12: Intrinsic Functions for Inserting Assembly Instructions 
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1.5.6_ REGISTER HANDLING 


Access Control Registers 


The next table provides an overview of the intrinsic functions that you can 


use to acces control registers. 


Intrinsic Function 


Description 


int _ mfcr( int ) 


void _ mtcr ( int,int ) 


move contents of the addressed core SFR 
into a data register 


move contents of a data register (second int) 
to the addressed core SFR (first int) 


Table 1-13: Intrinsic Functions for Accessing Control Registers 


Perform Register Value Operations 


The next table provides an overview of the intrinsic functions that operate 
on a register and return a value in another register. 


Description 


Intrinsic Function 
int _ clz ( int ) 
int _ clo ( int ) 
int _ cls ( int ) 
int _ satb ( int ) 
int _ satbu ( int ) 
int _ sath ( int ) 
int _ sathu ( int ) 
int _ abs ( int ) 
int _ abss ( int ) 
int _ parity ( int ) 


Count leading zeros in int 
Count leading ones in int 


Count number of redundant sign bits (all 
consecutive bits with the same value as bit 31) 


Return saturated byte 

Return saturated unsigned byte 
Return saturated halfword 

Return saturated unsigned halfword 
Return absolute value 

Return absolute value with saturation 


Return parity 


Table 1-14: Intrinsic Functions for Performing Register Value Operations 
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1.5.7 INSERT / EXTRACT BIT-FIELDS AND BITS 


Insert / Extract Bit-fields 


The next table provides an overview of the intrinsic functions to insert or 
extract a bit-field. 


Intrinsic Function Description 

int _ extr ( int value, Extract a bit-field (bit pos to bit 
int pos,int width ) pos+width) from value 

unsigned int _ extru ( int Same as __ extr() but return bit-field 
value,int pos,int width ) as unsigned integer 

int _ insert ( int src,int Extract bit-field (bit pos to bit 
trg, int pos,int width ) pos+width) from src and insert it in trg. 


int _ins( int trg, int trgbit, | Return trg but replace trgbit by srcbit 
int src, int srcbit ) in sre. 


int _insn(int trg, int trgbit, | Return trg but replace trgbit by inverse 
int src, int srcbit ) of srcbit in src. 


Table 1-15: Intrinsic Functions to Insert / Extract Bit-fields 


Atomic Load-Modify-Store 


With the next intrinsic function you can peform atomic Load-Modify-Store 
of a bit-field from an integer value. This function uses the IMASK and 
LDMST instruction. The intrinsic writes the number of bits of an integer 
value at a certain address location in memory with a bitoffset. The number 
of bits must be a constant value. 


Intrinsic Function 


void _ imaskldmst(int* address,int value,int bitoffset,int bits) 


Store a single bit 


With the intrinsic macro __ putbit() you can store a single bit atomicly 
in memory at a specified bit offset. The bit at offset 0 in value is stored at 
an address location in memory with a bitoffset. 


This intrinsic is implemented as a macro definition which uses the 
_imaskldmst() intrinsic: 


#define putbit ( value, address, bitoffset ) _ imaskldmst 
( address, value, bitoffset, 1 ) 
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Intrinsic Macro 


void _ putbit( int value, int* address, int bitoffset ) 


Load a single bit 


With the intrinsic macro __ getbit() you can load a single bit from 
memory at a specified bit offset. A bit value is loaded from an address 


location in memory with a bitoffset and returned as an unsigned integer 
value. 


This intrinsic is implemented as a macro definition which uses the 
__extru() intrinsic function: 


#define _getbit ( address, bitoffset ) _extru ( *(address), 
bitoffset, 1 ) 


Intrinsic Macro 


unsigned integer _ getbit( int* address, int bitoffset ) 
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1.5.8 MISCELLANEOUS INTRINSIC FUNCTIONS 


Multiply aud Scale Back 


The next intrinsic multiplies two 32-bit numbers to an intermediate 64-bit 
result, and scales back the result to 32 bits. To scale back the result, 32 bits 
are extracted from the intermediate 64-bit result: bit 63-offset to bit 
31-offset. 


Intrinsic Function 


int _ mulsc( int a, int b, int offset ) 


Swap Mask 


The next intrinsic exchanges the values of value and memory, but only 
those bits that are allowed by mask. Before the __ swapmsk instruction is 


generated, the parameters value and mask are moved into a double 
register. 


& This intrinsic is only supported for the TriCore2 (—-is-tricore2). 


Intrinsic Function 


void _ swapmsk ( int value, int mask, int * memory ) 


Tnitialize Circular Pointer 


With the next intrinsic you can initialize a circular pointer with a 
dynamically allocated buffer at run-time. 


Intrinsic Function 


_ circ void * _ initcirc( void * buf, unsigned short bufsize, 
unsigned short byteindex ) 


d> See also Section 3.4.1, Circular Buffers, in Chapter TriCore C Language of 
the User’s Manual. 
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1.6 PRAGMAS 


Pragmas are keywords in the C source that control the behavior of the 
compiler. Pragmas overrule compiler options and keywords. 


d> For general information on pragmas see section 3.7, Pragmas to Control 
the Compiler, in Chapter TriCore C Language of the User's Manual. 


The syntax is: 


#pragma pragma-spec [ON | OFF | RESTORE | DEFAULT] 


OT: 
_Pragma("pragma-spec [ON | OFF | RESTORE | DEFAULT]”) 


The compiler recognizes the following pragmas, other pragmas are 
ignored. Sometimes the resemblence of a pragma and a compiler option is 
so strong, that no explanation is given but instead is referred to the 
description of the corresponding compiler option. 


#pragma CPU functiional_ problem 
#pragma DMU functional_ problem 


Use software workarounds for the specified functional problem. 


d> See compiler option —-silicon-bug in section Compiler Options in 
Chapter 700/ Options. 


#pragma alias symbol-defined symbol 


Define symbol as an alias for defined_symbol. It corresponds to an equate 
directive (.EQU) at assembly level. The symbol should not be defined 
elsewhere, and defined_symbol should be defined with static storage 
duration (not extern or automatic). 


d> See also the .EOU directive directive in Section 3.3, Assembler Directives 
and Controls, in Chapter Assembly Language. 


#pragma align n 
#pragma align restore 


d> See compiler option —-align in section Compiler Options in Chapter Tool 
Options. restore returns to the previous pragma level if the same 
pragma is used more than once. 
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#pragma clear 
#pragma noclear 


Performs ’clearing’ or no 'clearing' of non-initialized static/public variables. 


#pragma default_a0_size [value] 


d> See compiler option —Z in section Compiler Options in Chapter Tool 
Options. 


#pragma default_a1_size [value] 


d> See compiler option -Y in section Compiler Options in Chapter Tool 
Options. 


#pragma default_near_size [value] 


d> See compiler option -N in section Compiler Options in Chapter Tool 
Options. 


#pragma extension isuffix 


Enables a language extension to specify imaginary floating—point 


constants. With this extension, you can use an ”i” suffix on a floating-point 
constant, to make the type _Imaginary: 


float 0.5i 


#pragma extern symbol 


Normally, when you use the C keyword extern, the compiler generates 
an .EXTERN directive in the generated assembly source. However, if the 
compiler does not find any references to the extern symbol in the C 
module, it optimizes the assembly source by leaving the . EXTERN 
directive out. 


With this pragma you force the compiler to generate the . EXTERN 
directive, creating an external symbol in the generated assembly source, 
even when the symbol is not used in the C module. 


d> See the EXTERN directive directive in Section 3.3, Assembler Directives 
and Controls, in Chapter Assembly Language. 
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#pragma for_constant_data_use_memory memory 
#pragma for_extern_data_use_memory memory 
#pragma for_initialized_data_use_memory memory 
#pragma for_uninitialized_data_use_memory memory 


Use the specified memory for the type of data mentioned in the pragma 
name. You can specify the following memories: 


near, far, a0, a8 or a9. 


For #pragma for_constant_data_use_memory you can also specify the 
al memory. 


This pragma overrules the pragmas #pragma default a0_ size, #pragma 
default_al_size, #pragma default_near_size, and the memory qualifiers 
near and far. 

#pragma indirect 
Generates code for indirect function calling. 

d> See compiler option —-indirect in section Compiler Options in Chapter 

Tool Options. 

#pragma indirect_runtime 
Generates code for indirect calls to run-time functions. 


d> See compiler option —-indirect_runtime in section Compiler Options in 
Chapter Tool Options. 


#pragma inline 
#pragma noinline 
#pragma smartinline 


d> See section 3.9.1, Inlining Functions of the User's Manual. 


#pragma macro 
#pragma nomacro 


Turns macro expansion on or off. Default, macro expansion is turned on. 


#pragma message string” ... 


Print the message string(s) on standard output. 
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#pragma object_comment string” ... 


This pragma generates a .comment section in the assembly file with the 
specified string. After assembling, this string appears in the generated .o 
or .elf object file. If you specify this pragma more than once in the same 
module, only the last pragma has effect. 


d> See compiler option --object-comment in section Compiler Options in 
Chapter Tool Options. 


#pragma optimize flags 
#pragma endoptimize 
#pragma optimize restore 


d> See section 5.3, Compiler Optimizations in Chapter Using the Compiler of 
the User's Manual. restore returns to the previous pragma level if the 
same pragma is used more than once. 


#pragma pack 2 
#pragma pack 0 


d> See section 3.2.4, Packed Data Types of the User's Manual. 


#pragma section all “section name” 
#pragma section section_type "section_mame” 
#pragma section code_init 

#pragma section const_init 

#pragma section vector_init 

#pragma section data_overlay 


d> See section 3.10, Compiler Generated Sections and 
compiler option -R in section Compiler Options in Chapter Tool Options. 


#pragma source 
#pragma nosource 


See compiler option —s in section Compiler Options in Chapter Tool 
Options. 
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#pragma switch auto 
#pragma switch jumptab 
#pragma switch linear 
#pragma switch lookup 
#pragma switch restore 


d> See section 3.11, Switch Statement of the User’s Manual and 
compiler option —-switch in section Compiler Options in Chapter Tool 
Options. 


#pragma tradeoff level 


Specify whether the used optizations should opimize for more speed (0), 
regardless of code size or for smaller code size (4), regardless of speed). 


See also compiler option -t (—-tradeoff) in section Compiler Options in 
Chapter Tool Options. 


#pragma warning [number,...] 


With this pragma you can disable warning messages. If you do not specify 
a warning number, all warnings will be suppressed. 


d> See also compiler option -w (——no-warnings) in section Compiler 
Options in Chapter Tool Options. 


#pragma weak symbol 


Mark a symbol as ”weak” (WEAK assembler directive). The symbol must 
have external linkage, which means a global or external object or function. 
A static symbol cannot be declared weak. 


A weak external reference is resolved by the linker when a global (or 
weak) definition is found in one of the object files. However, a weak 
reference will not cause the extraction of a module from a library to 
resolve the reference. When a weak external reference cannot be resolved, 
the null pointer is substituted. 


A weak definition can be overruled by a normal global definition. The 
linker will not complain about the duplicate definition, and ignore the 
weak definition. 


See the .WEAK directive directive in Section 3.3, Assembler Directives and 
Controls, in Chapter Assembly Language. 
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1.7 PREDEFINED MACROS 


In addition to the predefined macros required by the ISO C standard, the 


TASKING TriCore C compiler supports the predefined macros as defined in 


Table 1-16. The macros are useful to make conditional C code. 


Macro 


Description 


_ DOUBLE FP__ 


Defined when you do not use compiler option -F 
(Treat double as float) 


_ SINGLE FP__ 


Defined when you use compiler option -F (Treat 
double as float) 


_ FPU _ 


Defined when you use compiler option 
—-fpu-present (Use hardware floating-point 
instructions) 


_ CTC __ 


Identifies the compiler. You can use this symbol to flag 
parts of the source which must be recognized by the 
ctc compiler only. It expands to the version number of 
the compiler. 


_ TASKING __ 


Identifies the compiler as the TASKING TriCore 
compiler. It expands to 1. 


DSPC 


Indicates conformation to the DSP-C standard. It 
expands to 1. 


_ DSPC VERSION _ 


Expands to the decimal constant 200001L. 


_ VERSION _ 


Identifies the version number of the compiler. For 
example, if you use version 2.1r1 of the compiler, 
_ VERSION ___ expands to 2001 (dot and revision 
number are omitted, minor version number in 3 digits). 


_ REVISION __ 


Identifies the revision number of the compiler. For 
example, if you use version 2.1r1 of the compiler, 
_ REVISION __ expands to 1. 


_ BUILD _ 


Identifies the build number of the compiler, composed 
of decimal digits for the build number, three digits for 
the major branch number and three digits for the 
minor branch number. For example, if you use build 
1.22.1 of the compiler, _BUILD__ expands to 
1022001. If there is no branch number, the branch 
digits expand to zero. For example, build 127 results 
in 127000000. 


Table 1-16: Predefined macros 
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LIBRARIES 


ail TASKING M 


diLdVHO 


Libraries 


2.1 INTRODUCTION 


This chapter contains an overview of all library functions that you can call 


in your C source. This includes all functions of the standard C library 
(libc.a) and some functions of the floating-point library (libfp.a or 


libfpt.a). 


Section 2.2, Library Functions, gives an overview of all library functions 


you can use, grouped per header file. A number of functions declared in 


wchar -h are parallel to functions in other header files. These are 
discussed together. 


Section 2.3, C Library Reentrancy, gives an overview of which functions 
are reentrant and which are not. 


The following libraries are included in the TriCore (ctc) toolchain. Both 
EDE and the control program cctc automatically select the appropriate 
libraries depending on the specified TriCore derivative. 


Library to link | Description 

libc.a C library 
(Some functions require the floating-point library. Also 
includes the startup code.) 

libcs.a C library single precision (compiler option -F) 
(Some functions require the floating-point library. Also 
includes the startup code.) 

libcs_fpu.a C library single precision with FPU instructions (compiler 
option -F and —-fpu-present) 

libfp.a Floating-point library (non-trapping) 

libfpt.a Floating-point library (trapping) 
(Control program option —-fp-trap) 

libfp_fpu.a Floating-point library (non-trapping, with FPU instructions) 
(Compiler option --fpu-present) 

libfpt_fpu.a Floating-point library (trapping, with FPU instructions) 
(Control program option —-fp-trap, compiler option 
—-fpu-present) 

librt.a Run-time library 


Table 2-1: Overview of libraries 
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2.2 LIBRARY FUNCTIONS 


The tables in the sections below list all library functions, grouped per 
header file in which they are declared. Some functions are not completely 
implemented because their implementaion depends on the context where 
your application will run. These functions are for example all I/O related 
functions. Where possible, these functions are implemented using file 
system simulation (FSS). This system can be used by CrossView Pro to 
simulate an I/O environment which enables you to debug your 
application. 


2.2.1  ASSERT.H 


assert (expr) Prints a diagnostic message if NDEBUG is not defined. 
(Implemented as macro) 


2.2.2 COMPLEX.H 


The complex number z is also written as x+yi where x (the real part) and 
y (the imaginary part) are real numbers of types float, double or long 
double. The real and imaginary part can be stored in structs or in arrays. 
This implementation uses arrays because structs may have different 
alignments. 


The header file complex.h also defines the following macros for 
backward compatibility: 


complex _Complex /* C99 keyword */ 
imaginary _Imaginary /* C99 keyword */ 


Parallel sets of functions are defined for double, float and long double. 
They are respectively named function, function£, function1. All long 
type functions, though declared in complex.h, are implemented as the 
double type variant which nearly always meets the requirement in 
embedded applications. 


This implementation uses the obvious implementation for complex 
multiplication; and a more sophisticated implementation for divison and 
absolute value calculations which handles underflow, overflow and 
infinities with more care. The ISO/IEC 9899 #pragma 

CX_LIMITED RANGE therefore has no effect. 


Libraries 


Trigonometric functions 


csin 
ccos 
ctan 
casin 
cacos 
catan 
csinh 
ccosh 
ctanh 
casinh 
cacosh 


catanh 


csinf 

ccosf 

ctanf 

casinf 
cacosf 
catanf 
csinhf 
ccoshf 
ctanhf 
casinh 


cacosh 


csinl 
ccosl 
ctanl 
casinl 
cacosl 
catanl 
csinhl 
ccoshl 
ctanhl 
cfasinhl 


cfacoshl 


catanhfcatanhl 


Returns the complex sine of z. 

Returns the complex cosine of z. 

Returns the complex tangent of z. 

Returns the complex arc sine sin-!(z). 

Returns the complex arc cosine cos-1(z). 
Returns the complex arc tangent tan-1(z). 
Returns the complex hyperbolic sine of z. 
Returns the complex hyperbolic cosine of z. 
Returns the complex hyperbolic tangent of z. 
Returns the complex arc hyperbolic sinus of z. 
Returns the complex arc hyperbolic cosinus of z. 
Returns the complex arc hyperbolic tangent of z. 


Exponential and logarithmic functions 


cexp 


clog 


cexpf 


clogf 


cexpl 


clogl 


Returns the result of the complex exponential 
function eZ. 


Returns the complex natural logarithm. 


Power and absolute-value functions 


cabs 


cpow 


csgrt 


cabsf 


cpowf 


csgrtf 


cabsl 


cpowl 


csgrtl 


Manipulation functions 


carg 


cimag 


conj 


cargf 


cimagf 


conjf 


cargl 


cimagl 


conjl 


Returns the complex absolute value of z (also 
known as norm, modulus or magnitude). 


Returns the complex value of z raised to the 
power w (2”) where both z and w are complex 
numbers. 


Returns the complex sguare root of z. 


Returns the argument of z (also known as phase 
angle). 


Returns the imaginary part of z as a real (re- 
spectively as a double, float, long double) 


Returns the complex conjugate value (the sign 
of its imaginary part is reversed). 
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cproj cprojf cprojl Returns the value of the projection of z onto the 
Riemann sphere. 


creal crealf creall Returns the real part of z (respectively as a 
double, float, long double) 


2.2.3 CTYPE.H AND WCTYPE.H 


The header file ctype.h declares the following functions which take a 
character c as an integer type argument. The header file wctype.h 
declares parallel wide-character functions which take a character c of the 
wchar_t type as argument. 


Ctype.h Wctype.h Description 


isalnum iswalnum Returns a non-zero value when c is an alpha- 
betic character or a number ([A-Z][a-z][0-9]). 

isalpha iswalpha Returns a non-zero value when c is an alphabetic 
character ([A-Z][a-z]). 

isblank iswblank Returns a non-zero value when c is a blank 
character (tab, space...) 

iscntrl iswcntrl Returns a non-zero value when c is a control 
character. 

isdigit iswditit Returns a non-zero value when c is a numeric 
character ([0-9]). 

isgraph iswgraph Returns a non-zero value when c is printable, but 
not a space. 

islower iswlower Returns a non-zero value when c is a lowercase 
character ([a-z]). 

isprint iswprint Returns a non-zero value when c is printable, 
including spaces. 

ispunct iswpunct Returns a non-zero value when c is a punctuation 
character (such as '.', ',', T). 

isspace iswspace Returns a non-zero value when c is a space type 


character (space, tab, vertical tab, formfeed, 
linefeed, carriage return). 


isupper iswupper Returns a non-zero value when c is an uppercase 
character ([A-Z]). 


isxdigit iswxdigit Returns a non-zero value when c is a 
hexadecimal digit ([0-9][A-F][a-f]). 


Libraries 


Ctype.h 


Wctype.h 


Description 


tolower 


toupper 


_tolower 


_toupper 


isascii 


toascii 


towlower 


towupper 


2.2.4 ERRNO.H 


int errno 


Returns c converted to a lowercase character if it 
is an uppercase character, otherwise c is returned. 


Returns c converted to an uppercase character if it 
is a lowercase character, otherwise c is returned. 


Converts c to a lowercase character, does not 
check if c really is an uppercase character. 
Implemented as macro. This macro function is not 
defined in ISO/IEC 9899. 


Converts c to an uppercase character, does not 
check if c really is a lowercase character. 
Implemented as macro. This macro function is not 
defined in ISO/IEC 9899. 


Returns a non-zero value when c is in the range 
of 0 and 127. 
This function is not defined in ISO/IEC 9899. 


Converts c to an ASCII value (strip highest bit). 
This function is not defined in ISO/IEC 9899. 


External variable that holds implementation defined error codes. 


The following error codes are defined as macros in errno.h: 
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EZERO 0 No error 

EPERM 1 Not owner 

ENOENT 2 No such file or directory 
EINTR 3 Interrupted system call 
EIO 4 I/O error 

EBADF 5 Bad file number 
EAGAIN 6 No more processes 
ENOMEM 7 Not enough core 
EACCES 8 Permission denied 
EFAULT 9 Bad address 

EEXIST 10 File exists 

ENOTDIR 11 Not a directory 

EISDIR 12 Is a directory 

EINVAL 13 Invalid argument 
ENFILE 14 File table overflow 
EMFILE 15 Too many open files 
ETXTBSY 16 Text file busy 

ENOSPC 17 No space left on device 
ESPIPE 18 Illegal seek 

EROFS 19 Read-only file system 
EPIPE 20 Broken pipe 

ELOOP 21 Too many levels of symbolic links 
ENAMETOOLONG 22 File name too long 


Floating-point errors 


EDOM 23 Argument too large 
ERANGE 24 Result too large 


Errors returned by prinff/scanf 


ERR_FORMAT 25 Illegal format string for printf/scanf 
ERR_NOFLOAT 26 Floating-point not supported 
ERR_NOLONG 27 Long not supported 

ERR_NOPOINT 28 Pointers not supported 


Error returned by file positioning routines 
ERR_POS 29 Positioning failure 


Encoding error stored in errno by functions like fgetwc, getwc, 
mbrtowc, etc... 


EILSEQ 30 Illegal byte sequence (including too few bytes) 


Libraries 


2.2.5 FCNTL.H 


The header file fcntl.h contains the function open(), which calls the 
low level function _ open (), and definitions of flags used by the low level 
function _ open (). This header file is not defined in ISO/IEC9899. 


open 


2.2.6 FENV.H 


Opens a file a file for reading or writing. Calls _ open. 
(FSS implementation) 


Contains mechanisms to control the floating-point environment. The 
functions in this header file are not implemented. 


fegetenv 


feholdexept 


fesetenv 


feupdateenv 


feclearexcept 


fegetexceptflag 


feraiseexcept 


fesetexceptflag 


fetestexcept 


Stores the current floating-point environment. 
(Not implemented) 


Saves the current floating-point environment and installs 
an environment that ignores all floating-point 
exceptions. (Not implemented) 


Restores a previously saved (fegetenv or feholdexcept) 
floating-point environment. (Not implemented) 


Saves the currently raised floating-point exceptions, 
restores a previousely saved floating-point environment 
and finally raises the saved exceptions. 

(Not implemented) 


Clears the current exception status flags corresponding 
to the flags specified in the argument. (Not implemented) 


Stores the current setting of the floating-point status 
flags. (Not implemented) 


Raises the exceptions represented in the argument. As a 
result, other exceptions may be raised as well. 
(Not implemented) 


Sets the current floating-point status flags. 
(Not implemented) 


Returns the bitwise-OR of the exception macros corre- 
sponding to the exception flags which are currently set 
and are specified in the argument. (Not implemented) 


For each supported exception, a macro is defined. The following 
exceptions are defined: 
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FE DIVBYZERO FE INEXACT FE INVALID 
FE OVERFLOW FE UNDERFLOW FE ALL EXCEPT 
fegetround Returns the current rounding direction, represented as 


one of the values of the rounding direction macros. 
(Not implemented) 


fesetround Sets the current rounding directions. (Not implemented) 


Currently no rounding mode macros are implemented. 


2.2.7 FLOAT.H 


The header file float .h defines the characteristics of the real 
floating-point types float, double and long double. 


& Float.h used to contain prototypes for the functions copysign(f), 

isinf(f), isfinite(f), isnan(f) and scalb(f). These functions have 
accordingly to the ISO/IEC9899 standard been moved to the header file 
math.h. See also section 2.2.13, Math.h and Tgmath.h. 


2.2.8 _ FSS.H 


The header file fss.h contains definitions and prototypes for low level 
I/O functions used for CrossView Pro's file system simulation (FSS). The 
low level functions are also declared in stdio.h; they are all 
implemented as FSS functions. This header file is not defined in 
ISO/IEC9899. 


Stdio.h Description 


Buffer and breakpoint functions for 


GR EFE OU CrossView Pro 


Opens file descriptors O (stdin), 1 
(stdout) and 2 (stderr) and associates 
them with terminal window FSS_0 of 
CrossView Pro. 


_fss init(fd,is close) 


_close(fd) 

_lseek(fd,offset,whence) 

_open(fd, flags) See Low Level File Access Functions 
_read(fd,*buff,cnt) in section 2.2.20, Stdio.h. 


_unlink(*name) 
_write(fd,*buffer,cnt) 


Libraries 


2.2.9 


INTTYPES.H AND STDINT.H 


The header files stdint.h and inttypes.h provide additional 
declarations for integer types and have various characteristics. The 
stdint.h header file contains basic definitions of integer types of certain 
sizes, and corresponding sets of macros. This header file clearly refers to 
the corresponding sections in the ISO/IEC 9899 standard. 

The inttypes.h header file incldues stdint.h and adds portable 
formatting and conversion functions. Below the conversion functions from 


inttypes.h are listed. 


intmax_t imaxabs(intmax_t j); 


imaxdiv_t imaxdiv(intmax_t numer, 
intmax_t denom); 


intmax_t strtoimax(const char * 
restrict nptr, char ** restrict 
endptr, int base); 


uintmax_t strtoumax(const char * 
restrict nptr, char ** restrict 
endptr, int base); 


intmax_t wcstoimax(const wchar_t 
* restrict nptr, wchar_t ** 
restrict endptr, int base); 


uintmax_t wcstoumax(const wchar_t 
* restrict nptr, wchar_t ** 
restrict endptr, int base); 


Returns the absolute value of j 


Computes numer/denom and 
numer 96 denom. The result is 
stored in the guot and rem 
components of the imaxdiv_t 
structure type. 


Convert string to maximum sized 
integer. (Compare strtoll) 


Convert string to maximum sized 
unsigned integer. (Compare 
strtoull) 


Convert wide string to maximum 
sized integer. (Compare wcstoll) 


Convert wide string to maximem 
sized unsigned integer. (Compare 
wcstoull) 
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The header file iso646.h adds tokens that can be used instead of regular 
operator tokens. 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


and 
and_eq 
bitand 
bitor 
compl 
not 
not_eq 
or 
or_eg 
xor 
xor_eg 


2.2.11 LIMITS.H 


Contains the sizes of integral types, defined as macros. 


2.2.12 LOCALE.H 


To keep C code reasonable portable accross different languages and 
cultures, a number of facilities are provided in the header file local.h. 


char *setlocale( int category, const char *locale ) 


The function above changes locale-specific features of the run-time 
library as specified by the category to change and the name of the 


locale. 


The following categories are defined and can be used as input for this 


function: 


LC ALL 


LC COLLATE 


LC CTYPE 


LC NUMERIC 


> 


LC_MONETARY 5 


Libraries 


struct lconv *localeconv( void ) 


Returns a pointer to type stuct lconv with values appropriate for 
the formatting of numeric guantities according to the rules of the 
current locale. The struct lconv in this header file is conforming the 
ISO standard. 


2.2.13 MATH.H AND TGMATH.H 


The header file math .h contains the prototypes for many mathematical 
functions. Before C99, all functions were computed using the double type 
(the float was automatically converted to double, prior to calculation). In 
this C99 version, parallel sets of functions are defined for double, float and 
long double. They are respectively named function, function£, function1. 
All 1ong type functions, though declared in math.h, are implemented as 
the double type variant which nearly always meets the reguirement in 
embedded applications. 


The header file tgmath.h contains parallel type generic math macros 
whose expansion depends on the used type. tgmath.h includes math.h 
and the effect of expansion is that the correct math .h functions are called. 
The type generic macro, if available, is listed in the second column of the 
tables below. 


Trigonometric functions 


Math.h Tgmath.h Description 

sin sinf sinl sin Returns the sine of x. 

cos cosf cosl cos Returns the cosine of x. 

tan tanf tanl tan Returns the tangent of x. 

asin asinf asinl asin Returns the arc sine sin! (x) of x. 
acos acosf acosl acos Returns the arc cosine cos”! (x) of x. 
atan atanf atanl atan Returns the arc tangent tan~! (x) of x. 
atan2 atan2f atan21 atan2 Returns the result of: tan-'(y/x). 
sinh sinhf sinhl sinh Returns the hyperbolic sine of x. 
cosh coshf coshl cosh Returns the hyperbolic cosine of x. 
tanh tanhf tanhl tanh Returns the hyperbolic tangent of x. 


asinh asinhf asinhl asinh Returns the arc hyperbolic sinus of x. 


2-14 TriCore Reference Manual 


Math.h Tgmath.h Description 


acosh acoshf acoshl acosh Returns the non-negative arc hyper- 
bolic cosinus of x. 


atanh atanhf atanhl atanh Returns the arc hyperbolic tangent of 
X. 


Exponential and logarithmic functions 


All of these functions are new in C99, except for exp, log and log10. 


Math.h Tgmath.h Description 

exp  expf expl exp Returns the result of the exponential 
function ex. 

exp2 exp2f exp2l exp2 Returns the result of the exponential 
function 2X. (Not implemented) 

expml expmlf expmll expml Returns the result of the exponential 
function e*-1. (Not implemented) 

log logf logl log Returns the natural logarithm ln (x), 
x>0. 

log10 logl0f log10l log10 Returns the base-10 logarithm of x, 
x>0. 

loglp loglpf loglpl loglp Returns the base-e logarithm of 
(1+x).x <> -1. (Not implemented) 

log2 log2f log2l log2 Returns the base-2 logarithm of x. 


x>0. (Not implemented) 


ilogb ilogbf ilogbl ilogb Returns the signed exponent of x as 
an integer. x>0. (Not implemented) 


logb logbf logbl logb Returns the exponent of x as a signed 
integer in value in floating-point 
notation. x > 0. (Not implemented) 


Libraries 


Rounding functions 
Math.h 


Tgmath.h 


Description 


ceil ceilf ceill 


floor floorf floorl 


rint rintf rintl 


lrint lrintf lrintl 


llrint lrintf lrintl 


nearbyint nearbyintf 
nearbyintl 


round roundf roundl 


lround lroundf lroundl 


llround lroundf 
llroundl 


trunc truncf truncl 


ceil 


floor 


rint 


lrint 


llrint 


nearbyint 


round 


lround 


llround 


trunc 


Returns the smallest integer not 
less than x, as a double. 


Returns the largest integer not 
greater than x, as a double. 


Returns the rounded integer 
value as an int according to the 
current rounding direction. See 
fenv.h. (Not implemented) 


Returns the rounded integer 

value as along int according 
to the current rounding direction. 
See fenv.h. (Not implemented) 


Returns the rounded integer 
value as a long long int 
according to the current rounding 
direction. See fenv.h. 

(Not implemented) 


Returns the rounded integer 
value as a floating-point 
according to the current rounding 
direction. See fenv.h. 

(Not implemented) 


Returns the nearest integer 
value of x as int. 
(Not implemented) 


Returns the nearest integer 
value of x as long int. 
(Not implemented) 


Returns the nearest integer 
value of x as long long int. 
(Not implemented) 


Returns the truncated integer 
value x. (Not implemented) 
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Math.h Tgmath.h Description 

fmod fmodf — fmodl fmod Returns the remainder r of 
x-ny. n is chosen as 
trunc(X/y).r has the same 
sign as x. 

remainder remainderf remainder Returns the remainder r of 

remainderl x-ny. n is chosen as 
trunc(X/y). r may not have the 
same sign as x. (Not implement- 
ed) 

remguo remguof remguol remguo Same as remainder. In addition, 


Srexp, ldexp, modf, scalbn, scalbin 


Math.h 


Tgmath.h 


the argument *quo is givena 
specific value (see ISO). 
(Not implemented) 


Description 


frexp frexpf frexpl 


ldexp ldexpf Ildexpl 


modf modff modfl 


scalbn scalbnf scalbnl 


scalbln scalblnf 
scalblnl 


frexp 


ldexp 


scalbn 


scalbln 


Splits a float x into fraction f and 
exponent n, so that: 

f = 0.0 or 0.5 < | f | < 1.0 and 
f*2" = x. Returns f, stores n. 


Inverse of frexp. Returns the 
result of x*2n. 
(x and n are both arguments). 


Splits a float x into fraction f and 
integer n, so that: 

| f| < 1.0 and f+n=x. Returns f, 
stores n. 


Computes the result of 
x*FLT RADIX". efficiently, not 
normally by computing 
FLT RADIX" explicitly. 


Same as scalbn but with 
argument n as long int. 


Libraries 


Power and absolute-value functions 


Math.h Tgmath.h Description 

cbrt cbrtf cbrtl cbrt Returns the real cube root of x 
(=x1/3). (Not implemented) 

fabs fabsf fabsl fabs Returns the absolute value of x 
(|x|). (abs, labs, llabs, div, 
ldiv, lldiv are defined in 
stdlib.h) 

fma fmaf  fmal fma Floating-point multiply add. Re- 
turns x*y+z. (Not implemented) 

hypot hypotf hypotl hypot Returns the sguare root of 
x2ty2, 

pow powf  powl power Returns x raised to the power y 
(xY). 

sqrt sqrtf sqrtl sqrt Returns the non-negative 


square root of x. x# 0. 


Manipulation functions: copysign, nan, nextafter, nexttoward 


Math.h Tgmath.h Description 
copysign copysignf copysign Returns the value of x with the 
copysignl sign of y. 
nan nanf nanl - Returns a quiet NaN, if 
available, with content indcated 
through tagp. 
(Not implemented) 
nextafter nextafterf nextafter Returns the next representable 
nextafterl value in the specified format 
after x in the direction of y. 
Returns y is x=y. 
(Not implemented) 
nexttoward nexttowardf nexttoward Same as nextafter, except 


nexttowardl 


that the second argument in all 
three variants is of type long 
double. Returns y if x=y. 

(Not implemented) 
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Math.h Tgmath.h Description 

fdim fdimf fdiml fdim Returns the positive difference 
between: |x-y|. 
(Not implemented) 

fmax fmaxf fmaxl fmax Returns the maximum value of 
their arguments. 
(Not implemented) 

fmin fminf fminl fmin Returns the minimum value of 


Error and gamma (Not implemented) 


their arguments. 
(Not implemented) 


Math.h Tgmath.h Description 

erf erff erfl erf Computes the error function of x. 
(Not implemented) 

erfc  erfcf erfcl erc Computes the complementary 
error function of x. 
(Not implemented) 

lgamma lgammaf lgammal lgamma Computes the *1log. |I'(x) | 
(Not implemented) 

tgamma tgammaf tgammal tgamma Computes T (x) 


(Not implemented) 


Libraries 


Comparison macros 


The next are implemented as macros. For any ordered pair of numeric 
values exactly one of the relationships — less, greater, and equal — is true. 
These macros are type generic and therefor do not have a parallel function 
in tgmath.h. All arguments must be expressions of real-floating type. 


Math.h Tgmath.h Description 

isgreater - Returns the value of (x) > (y) 

isgreaterequal - Returns the value of (x) >= (y) 

isless - Returns the value of (x) < (y) 

islessegual - Returns the value of (x) <= (y) 

islessgreater - Returns the value of (x) < (y) || 
(x) > (y) 

isunordered - Returns 1 if its arguments are 


Classification macros 


unordered, O otherwise. 


The next are implemented as macros. These macros are type generic and 
therefor do not have a parallel function in tgmath.h. All arguments must 


be expressions of real-floating type. 


Math.h Tgmath.h Description 

fpclassify - Returns the class of its argument: 
FP_INFINITE, FP NAN, FP_ NORMAL, 
FP_SUBNORMAL Or FP_ZERO 

isfinite - Returns a nonzero value if and only if 
its argument has a finite value 

isinf - Returns a nonzero value if and only if 
its argument has an infinit value 

isnan - Returns a nonzero value if and only if 
its argument has NaN value. 

isnormal - Returns a nonzero value if an only if 
its argument has a normal value. 

signbit - Returns a nonzero value if and only if 


its argument value is negative. 
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2.2.14 SETJMP.H 


The setjmp and longjmp in this header file implement a primitive form 
of nonlocal jumps, which may be used to handle exceptional situations. 
This facility is traditionally considered more portable than signal.h. 


int setjmp(jmp buf env) Records its caller's environment in env and 
returns 0. 


void longjmp(jmp_buf env, Restores the environment previously saved 
int status) with a call to set jmp(). 


2.2.15 SIGNAL.H 


Signals are possible asynchronous events that may require special 
processing. Each signal is named by a number. The following signals are 


defined: 

SIGINT 1 Receipt of an interactive attention signal 

SIGILL 2 Detection of an invalid function message 

SIGFPE 3 An errouneous arithmetic operation (for example, zero 
devide, overflow) 

SIGSEGV 4 An invalid access to storage 

SIGTERM 5 A termination request sent to the program 

SIGABRT 6 Abnormal terminiation, such as is initiated by the abort 
function 


The next function sends the signal sig to the program: 
int raise(int sig) 

The next function determines how subseguent signals will be handled: 
signalfunction *signal (int, signalfunction *); 


The first argument specifies the signal, the second argument points to the 
signal-handler function or has one of the following values: 


SIG DFL Default behavior is used 
SIG IGN The signal is ignored 


The function returns the previous value of signalfunction for the 
specific signal, or SIG_ERR if an error occurs. 


Libraries 
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2.2.16 STDARG.H 


The facilities in this header file gives you a portable way to access variable 
arguments lists, such as needed for as fprintf and vfprintf. This 
header file contains the following macros: 


va arg(ap,type) 


va_end(va list ap) 


va start(va list ap, 
lastarg); 


2.2.17 STDBOOL.H 


Returns the value of the next argument in the 
variable argument list. It’s return type has the 
type of the given argument type. A next call to 
this macro will return the value of the next 
argument. 


This macro must be called after the arguments 
have been processed. It should be called before 
the function using the macro 'va_start' is 
terminated (ANSI specification). 


This macro initializes ap. After this call, each call 
to va_arg() will return the value of the next 
argument. In our implementation, va_list 
cannot contain any bit type variables. Also the 
given argument lastarg must be the last 
non-bit type argument in the list. 


This header file contains the following macro definitions. These names for 
boolean type and values are consisten with C++. You are allowed to 
fundefine or redefine the macros below. 


#define bool 
#define true 
#define false 


#define bool true false are defined 
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2.2.18 STDDEF.H 


This header file defines the types for common use: 


ptrdiff_t Signed integer type of the result of subtracting two pointers. 
size_t Unsigned integral type of the result of the sizeof operator. 
wchar_t Integer type to represent character codes in large character sets. 


Besides these types, the following macros are defined: 


NULL Expands to the null pointer constant 


offsetof(_type, _member) Expands to an integer constant expression 
with type size_t that is the offset in bytes 
of _member within structure type _type. 


2.2.19 STDINT.H 


d> See section 2.2.9, inttypes.h and stdint.h 


2.2.20 STDIO.H AND WCHAR.H 


Types 


The header file stdio.h contains for performing input and output. A 
number of also have a parallel wide character function or macro, defined 
in wchar.h. The header file wchar.h also stdio.h. 


In the C language, many I/O facilities are based on the concept of streams. 
The stdio.h header file defines the data type FILE which holds the 
information about a stream. An FILE object is created with the function 
fopen. The pointer to this object is used as an argument in many of the in 
this header file. The FILE object can contain the following information: 

e the current position within the stream 

e pointers to any associated buffers 

e indications of for read/write errors 


e end of file indication 


The header file also defines type fpos_t as an unsigned long. 


Libraries 


Macros 


Stdio.h Description 

BUFSIZ 512 Size of the buffer used by the setbuf/setvbuf function: 
512 

EOF =] End of file indicator. 

WEOF _ UINTMAX End of file indicator. 
NOTE: WEOF need not to be a negative number as long 
as its value does not correspond to a member of the 
wide character set. (Defined in wchar .h). 

FOPEN MAX Number of files that can be opened simultaneously: 4 


FILENAME MAX 100 


_IOFBF 
_IOLBF 
_ IONBF 


L tmpnam 


TMP MAX 0x8000 


stderr 
stdin 
stdout 


NOTE: According to ISO/IEC 9899 this value must be at 
least 8. 


Maximum length of a filename: 100 


Expand to an integer expression, suitable for use as 
argument to the setvbuf function. 


Size of the string used to hold temporary file names: 8 
(tmpxxxxx) 


Maximum number of unique temporary filenames that 
can be generated: 0x8000 


Expressions of type "pointer to FILE” that point to the 
FILE objects associated with standard error, input and 
output streams. 
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Description 


_close(fd) 


_lseek(fd,offset,whence) 


_open(fd,flags) 
_read(fd,*buff,cnt) 
_unlink(*name) 


_write(fd,*buffer,cnt) 


File access 


Stdio.h 


Used by the functions close and fclose. 
(FSS implementation) 


Used by all file positioning functions: 
fgetpos, fseek, fsetpos, ftell, rewind. 
(FSS implementation) 


Used by the functions £open and 
freopen. (FSS implementation) 


Reads a seguence of characters from a 
file. (FSS implementation) 


Used by the function remove. 
(FSS implementation) 


Writes a sequence of characters to a file. 
(FSS implementation) 


Description 


fopen(name,mode) 


fclose(name) 


Opens a file for a given mode. Available 
modes are: 


r” read; open text file for reading 


yw” 


w” write; create text file for writing; 
if the file already exists its contents 
is discarded 


a” append; open existing text file or 
create new text file for writing at 
end of file 


open text file for update; reading 

and writing 

"w-r” create text file for update; previous 
contents if any is discarded 

”a+” append; open or create text file for 
update, writes at end of file 

(FSS implementation) 


Flushes the data stream and closes the 
specified file that was previously opened 
with fopen. (FSS implementation) 


Libraries 


Stdio.h Description 


fflush(name) If stream is an output stream, any 
buffered but unwritten date is written. 
Else, the effect is undefined. 


(FSS implementation) 
freopen(name,mode, Similar to fopen, but rather then 
stream) generating a new value of type FILE *, 


the existing value is associated with a 
new stream. (FSS implementation) 


setbuf(stream,buffer) If buffer is NULL, buffering is turned off 
for the stream. Otherwise, setbuf is 
eguivalent to: 


(void)setvbuf(stream,buf, 
_IOFBF,BUFSIZ). 


setvbuf(stream,buffer, Controls buffering for the stream; this 
mode,size) function must be called before reading or 
writing. Mode can have the following 
values: 


_IOFBF causes full buffering 

_IOLBF causes line buffering of 
text files 

_ IONBF causes no buffering 


If buffer is not NULL, it will be used as a 
buffer; otherwise a buffer will be 


allocated. size determines the buffer size. 


Character input/output 


The format string of printf related functions can contain plain text 
mixed with conversion specifiers. Each conversion specifier should be 
preceded by a ’%’ character. The conversion specifier should be build in 
order: 
— Flags (in any order): 
- specifies left adjustment of the converted argument. 


+ a number is always preceded with a sign character. 
+ has higher precedence than space. 


space a negative number is preceded with a sign, positive 
numbers with a space. 


0 specifies padding to the field width with zeros (only for 
numbers). 
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# specifies an alternate output form. For o, the first digit will 
be zero. For x or X, "0x” and ”0X” will be prefixed to the 
number. For e, E, f, g, G, the output always contains a 
decimal point, trailing zeros are not removed. 


- A number specifying a minimum field width. The converted 
argument is printed in a field with at least the length specified here. 
If the converted argument has fewer characters than specified, it will 
be padded at the left side (or at the right when the flag '—' was 
specified) with spaces. Padding to numeric fields will be done with 
zeros when the flag ’0’ is also specified (only when padding left). 
Instead of a numeric value, also ’*’ may be specified, the value is 
then taken from the next argument, which is assumed to be of type 
int. 

- A period. This separates the minimum field width from the 
precision. 


- A number specifying the maximum length of a string to be printed. 
Or the number of digits printed after the decimal point (only for 
floating-point conversions). Or the minimum number of digits to be 
printed for an integer conversion. Instead of a numeric value, also 
'*' may be specified, the value is then taken from the next 
argument, which is assumed to be of type int. 


- A length modifier 'h', P or ’L’. 'h” indicates that the argument is to 
be treated as a short or unsigned short number. 'I' should be used if 
the argument is a long integer. ’L’ indicates that the argument is a 
long double. 


Flags, length specifier, period, precision and length modifier are optional, 
the conversion character is not. The conversion character must be one of 
the following, if a character following ’%’ is not in the list, the behavior is 
undefined: 


Character Printed as 


d,i int, signed decimal 
o int, unsigned octal 
x, X int, unsigned hexadecimal in lowercase or uppercase 
respectively 
u int, unsigned decimal 


c int, single character (converted to unsigned char) 


Libraries 


Character Printed as 


s char *, the characters from the string are printed until a NULL 
character is found. When the given precision is met before, 
printing will also stop 


f double 
e E double 
g, G double 
n int *, the number of characters written so far is written into the 


argument. This should be a pointer to an integer in default 
memory. No value is printed. 


p pointer (hexadecimal 24-bit value) 
% No argument is converted, a '96' is printed. 


Table 2-2: Prinlf conversion characters 


All arguments to the seanf related functions should be pointers to 
variables (in default memory) of the type which is specified in the format 


string. 


The format string can contain : 


Blanks or tabs, which are skipped. 


Normal characters (not ’%’), which should be matched exactly in the 
input stream. 


Conversion specifications, starting with a ’%’ character. 


Conversion specifications should be built as follows (in order) : 


A”, meaning that no assignment is done for this field. 
A number specifying the maximum field width. 


The conversion characters d, i, n, o, u and x may be preceede by 
'h' if the argument is a pointer to short rather than int, or by I 
(letter ell) if the argument is a pointer to long. The conversion 
characters e, f, and g may be preceede by T if a pointer double 
rather than float is in the argument list, and by ’L’ if a pointer to a 
long double. 


A conversion specifier. ™, maximum field width and length modifier 
are optional, the conversion character is not. The conversion 
character must be one of the following, if a character following 96 
is not in the list, the behavior is undefined. 
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Length specifier and length modifier are optional, the conversion character 
is not. The conversion character must be one of the following, if a 
character following ’%’ is not in the list, the behavior is undefined. 


Character Scanned as 


d int, signed decimal. 


i int, the integer may be given octal (i.e. a leading O is entered) 
or hexadecimal (leading ”0x” or ”0X”), or just decimal. 


int, unsigned octal. 
int, unsigned decimal. 
int, unsigned hexadecimal in lowercase or uppercase. 


single character (converted to unsigned char). 


o o xX c o 


char *, a string of non white space characters. The argument 
should point to an array of characters, large enough to hold the 
string and a terminating NULL character. 


f float 
e E float 
g, G float 


n int *, the number of characters written so far is written into the 
argument. No scanning is done. 


p pointer; hexadecimal 24-bit value which must be entered 
without 0x- prefix. 


[..] Matches a string of input characters from the set between the 
brackets. A NULL character is added to terminate the string. 
Specifying []...] includes the ']' character in the set of scanning 
characters. 


Ua] Matches a string of input characters not in the set between the 
brackets. A NULL character is added to terminate the string. 
Specifying [^]...] includes the ']' character in the set. 


96 Literal '9o', no assignment is done. 


Table 2-3: Scanf conversion characters 


Libraries 


Stdio.h 


Wchar.h 


Description 


fgetc(stream) 


getc(stream) 


getchar(stdin) 


fgets(*s, n, 
stream) 


gets(*s, n, stdin) 


ungetc(c, stream) 


fscanf(stream, 
format,...) 


fgetwc(stream) 


getwc(stream) 


getwchar(stdin) 


fgetws(*s, n, 
stream) 


ungetwc(c, stream) 


fwscanf(stream, 
format,...) 


Reads one character from 
stream. Returns the read 
character, or EOF/WEOF on 
error. (FSS implementation) 


Same as fgetc/fgetwc 
except that is implemented 
as a macro. 

(FSS implementation) 
NOTE: Currently #defined 
as getchar()/getwchar() 
because FILE I/O is not 
supported. Returns the read 
character, or EOF/WEOF on 
error. 


Reads one character from 
the stdin stream. Returns 
the character read or 
EOF/WEOF on error. 
Implemented as macro. 
(FSS implementation) 


Reads at most the next n-1 
characters from the stream 
into array s until a newline is 
found. Returns s or NULL or 
EOF/WEOF on error. 

(FSS implementation) 


Reads at most the next n-1 
characters from the stdin 
stream into array s. A 
newline is ignored. Returns 
s or NULL or EOF/WEOF on 
error. (FSS implementation) 


Pushes character c back 
onto the input stream. 
Returns EOF/WEOF on 
error. 


Performs a formatted read 
from the given stream. 
Returns the number of items 
converted succesfully. 

(FSS implementation) 
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Description 


scanf(format,...) 


sscanf(*s, 
format,...) 


vfscanf(stream, 


format,arg) 


vscanf(format, 
arg) 


vsscanf(*s, 
format,arg) 


fputc(c, stream) 


putc(c, stream) 


putchar(c, stdout) 


fputs(*s, stream) 


wscanf(format,...) 


swscanf(*s, 
format,...) 


vfwscanf(stream, 


format,arg) 


vwscanf(format, 
arg) 


vswscanf(*s, 
format,arg) 


fputwc(c, stream) 


putwc(c, stream) 


putwchar(c, 
stdout) 


fputws(*s, stream) 


Performs a formatted read 
from stdin. Returns the 
number of items converted 
succesfully. 

(FSS implementation) 


Performs a formatted read 
from the string s. Returns 
the number of items 
converted succesfully. 


Same as fscanf/fwscanf, 
but extra arguments are 
given as variable argument 
list arg. (See section 2.2.16, 
stdarg.h) 


Same as sscanf/swscanf, 
but extra arguments are 
given as variable argument 
list arg. (See section 2.2.16, 
stdarg.h) 


Same as scanf/wscanf, but 
extra arguments are given 
as variable argument list 
arg. (See section 2.2.16, 
stdarg.h) 


Put character c onto the 
given stream. Returns 
EOF/WEOF on error. 
(FSS implementation) 


Same as fpuc/fputwc 
except that is implemented 
as a macro. 

(FSS implementation) 


Put character c onto the 
stdout stream. Returns 
EOF/WEOF on error. 
Implemented as macro. 
(FSS implementation) 


Writes string s to the given 
stream. Returns EOF/WEOF 
on error. 

(FSS implementation) 


Libraries 


Stdio.h 


Wchar.h 


Description 


puts(*s) 


fprintf(stream, 
format,...) 


printf(format, 


-) 


sprintf(*s, 
format,...) 


snprintf(*s, n, 
format,...) 


vfprintf(stream, 
format ,arg) 


vprintf(format, 
arg) 


vsprintf(*s, 
format,arg) 


fwprintf(stream, 
format,...) 


wprintf(format, 


..) 


swprintf(*s, n, 
format,...) 


vfwprintf(stream, 
format,arg) 


vwprintf(format, 
arg) 


vswprintf(*s, 
format,arg) 


Writes string s to the stdout 
stream. Returns EOF/WEOF 
on error. 

(FSS implementation) 


Performs a formatted write 
to the given stream. Returns 
EOF/WEOF on error. 

(FSS implementation) 


Performs a formatted write 
to the stream stdout. 
Returns EOF/WEOF on 
error. (FSS implementation) 


Performs a formatted write 
to string s. Returns 
EOF/WEOF on error. 


Same as sprintf, butn 
specifies the maximum 
number of characters 
(including the terminating 
null character) to be written. 


Same as 
fprintf/fwprintf, but 
extra arguments are given 
as variable argument list 
arg. (See section 2.2.16, 
stdarg.h) 

(FSS implementation) 


Same as printf/wprintf, 
but extra arguments are 
given as variable argument 
list arg. (See section 2.2.16, 
stdarg.h) 

(FSS implementation) 


Same as 
sprintf/swprintf, but 
extra arguments are given 
as variable argument list 
arg. (See section 2.2.16, 
stdarg.h) 
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Direct input/output 

Stdio.h Description 

fread(ptr,size,nobj,stream) Reads nobj members of size 
bytes from the given stream into 
the array pointed to by ptr. 
Returns the number of elements 
succesfully read. 
(FSS implementation) 

fwrite((ptr,size,nobj,stream) Writes nobj members of size 


bytes from to the array pointed to 
by ptr to the given stream. 
Returns the number of elements 
succesfully written. 

(FSS implementation) 


Random access 


Stdio.h Description 


fseek(stream, offset, Sets the position indicator for stream. 
origin) (FSS implementation) 


When repositioning a binary file, the new position origin is given by the following 
macros: 


SEEK_SET 0 offset characters from the beginning of the file 
SEEK_CUR 1 offset characters from the current position in the file 
SEEK_END 2 offset characters from the end of the file 


ftell(stream) Returns the current file position for stream, or 
-1L on error. (FSS implementation) 


rewind(stream) Sets the file position indicator for the stream to 
the beginning of the file. This function is 
equivalent to: 
(void) fseek(stream,0L,SEEK SET); 
clearerr(stream); 
(FSS implementation) 


fgetpos(stream,pos) Stores the current value of the file position 
indicator for stream in the object pointed to by 
pos. (FSS implementation) 


fsetpos(stream,pos) Positions stream at the position recorded by 
fgetpos in *pos. (FSS implementation) 


Libraries 


Operations on files 


Stdio.h 


Description 


remove(file) 


rename(old,new) 


tmpfile() 


tmpnam(buffer) 


Error handling 
Stdio.h 


Removes the named file, so that a subsequent 
attempt to open it fails. Returns a non-zero value if 
not succesful. 


Changes the name of the file from old name to new 
name. Returns a non-zero value if not succesful. 


Creates a temporary file of the mode ”wb+” that will be 
automatically removed when closed or when the 
program terminates normally. Returns a file pointer. 


Creates new file names that do not conflict with other 
file names currently in use. The new file name is 
stored in a buffer which must have room for 
L_tmpnam characters. Returns a pointer to the 
temporary name. The file names are created in the 
current directory and all start with "tmp”. At most 
TMP_MAX unigue file names can be generated. 


Description 


clearerr(stream) 


ferror(stream) 


feof(stream) 


perror(*s) 


Clears the end of file and error indicators for stream. 


Returns a non-zero value if the error indicator for 
stream is set. 


Returns a non-zero value if the end of file indicator for 
stream is set. 


Prints s and the error message belonging to the inte- 
ger errno. (See section 2.2.4, errno.h) 


2.2.21 STDLIB.H AND WCHAR.H 


The header file stdlib.h contains general utility functions which fall into 
the following categories (Some have parallel wide-character, declared in 


wchar.h) 


e Numeric conversions 


e Random number generation 


e Memory management 


e Envirnoment communication 


e Searching and sorting 
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e Integer arithmetic 
e Multibyte/wide character and string conversions. 


Macros 
RAND MAX 32767 Highest number that can be returned by the 
rand/srand function. 
EXIT SUCCES 0 Predefined exit codes that can be used in the exit 
EXIT FAILURE 1 function. 
MB CUR MAX 1 Maximum number of bytes in a multibyte character 


for the extended character set specified by the 
current locale (category LC_CTYPE, see section 
2.2.12, locale.h). 


Numeric conversions 


Next functions convert the intial portion of a string *s to a double, int, 
long int and long long int value respectively. 


double atof(*s) 
int atoi(*s) 
long atol(*s) 


long long atoll(*s) 


Next functions convert the initial portion of the string *s to a float, double 
and long double value respectively. *endp will point to the first character 
not used by the conversion. 


Stdlib.h Wchar.h 
float strtof(*s,**endp) float wcstof(*s,**endp) 
double strtod(*s,**endp) double westod(*s,**endp) 


long double strtold(*s,**endp) long double wcstold(*s,**endp) 
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Next functions convert the initial portion of the string *s to a long, long 
long, unsigned long and unsigned long long respectively. Base 
specifies the radix. *endp will point to the first character not used by the 


conversion. 


Stdlib.h 


long strtol (*s,**endp,base) 

long long strtoll 
(*s,**endp,base) 

unsigned long strtoul 
(*s,**endp,base) 


Wchar.h 


long wcstol (*s,**endp,base) 

long long wcstoll 
(*s,**endp,base) 

unsigned long wcstoul 
(*s,**endp,base) 


unsigned long long strtoull 


unsigned long long wcstoull 
(*s,**endp,base) 


(*s,**endp,base) 


Random number generation 


rand Returns a pseudo random integer in the range O to 
RAND_ MAX. 


Same as rand but uses seed for a new sequence of 
pseudo random numbers. 


srand(seed) 


Memory management 

malloc(size) Allocates space for an object with size size. 
The allocated space is not initialized. Returns a 
pointer to the allocated space. 


calloc(nobj,size) Allocates space for n objects with size size. 
The allocated space is initialized with zeros. 


Returns a pointer to the allocated space. 


free(*ptr) Deallocates the memory space pointed to by ptr 
which should be a pointer earlier returned by the 


malloc or calloc function. 


realloc(*ptr,size) Deallocates the old object pointed to by ptr and 
returns a pointer to a niew object with size size. 
The new object cannot have a size larger than the 


previous object. 


2-36 


- 


TriCore Reference Manual 


Environment communication 


abort() 


atexit(*func) 


exit(status) 


_Exit(status) 


getenv(*s) 


system(*s) 


Searching and sorting 


bsearch(*key,*base, 
n,size, 
*cmp) 


gsort(*base,n, 
size,*cmp) 


Causes abnormal program termination. If the 
signal SIGABRTis caught, the signal handler may 
take over control. (See section 2.2.15, signal.h). 


Func points to a function that is called (without 
arguments) when the program normally 
terminates. 


Causes normal program termination. Acts as if 
main ( ) returns with status as the return value. 
Status can also be specified with the predefined 
macros EXIT_SUCCES or EXIT_FAILURE. 


Same as exit, but not registered by the atexit 
function or signal handlers registerd by the 
signal function are called. 


Searches an environment list for a string s. 
Returns a pointer to the contents of s. 

NOTE: this function is not implemented because 
there is no OS. 


Passes the string s to the environment for 
execution. 

NOTE: this function is not implemented because 
there is no OS. 


This function searches in an array of n members, 
for the object pointed to by key. The initial base of 
the array is given by base. The size of each 
member is specified by size. The given array must 
be sorted in ascending order, according to the 
results of the function pointed to by cmp. Returns 
a pointer to the matching member in the array, or 
NULL when not found. 


This function sorts an array of n members using 
the guick sort algorithm. The initial base of the 
array is given by base. The size of each member 
is specified by size. The array is sorted in 
ascending order, according to the results of the 
function pointed to by cmp. 


Libraries 
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Integer arithmetic 
int abs(j) 
long labs(j) 


long long llabs(j) 
div_t div(x,y) 
ldiv_t ldiv(x,y) 
lldiv_t lldiv(x,y) 


Compute the absolute value of an int, long 
int, and long long intj resepectively. 


Compute x/y and x96y in a single operation. X 
and y have respectively type int, long int and 
long long int. The result is stored in the 
members quot and rem of struct div_t, 
ldiv_t and lldiv_t which have the same 


types. 


Multibyte/wide character and string conversions 


mblen(*s,n) 


mbtowc(*pwc,*s,n) 


wctomb(*s,wc) 


mbstowcs(*pwcs,*s,n) 


wcstombs(*s,*pwcs,n) 


Determines the number of bytes in the 
multi-byte character pointed to by s. At most n 
characters will be examined. (See also mbrlen 
in section 2.2.25, wchar.h) 


Converts the multi-byte character in s to a 
wide-character code and stores it in pwc. At 
most n characters will be examined. 


Converts the wide-character wc into a 
multi-byte representation and stores it in the 
string pointed to by s. At most MB. CUR_MAX 
characters are stored. 


Converts a seguence of multi-byte characters in 
the string pointed to by s into a seguence of wide 
characters and stores at most n wide characters 
into the array pointed to by pwcs. (See also 
mbsrtowcs in section 2.2.25, wchar.h) 


Converts a seguence of wide characters in the 
array pointed to by pwcs into multi-byte 
characters and stores at most n multi-byte 
characters into the string pointed to by s. (See 
also wcsrtowmb in section 2.2.25, wchar.h) 


2.2.22 STRING.H AND WCHAR.H 


This header file provides numerous functions for manipulating strings. By 
convention, strings in C are arrays of characters with a terminating null 
character. Most functions therefore take arguments of type *char. 
However, many functions have also parallel wide-character functions 
which take arguments of type *wchar_t. These functions are declared in 


wchar.h. 
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Description 


memcpy (*s1, 
*s2,n) 


memmove(*sl, 
*s2,n) 


strcpy(*sl,*s2) 


strncpy(*sl, 
*s2,n) 


strcat(*sl,*s2) 


strncat(*sl, 
*s2,n) 


wmemcpy(*sl, 
*s2,n) 


wmemmove(*sl, 
*s2,n) 


wcscpy(*sl,*s2) 


wcsncpy(*sl, 
*s2,n) 


wcscat(*sl,*s2) 


wcsncat(*sl, 
*s2,n) 


Copies n characters from 
*s2 into *s1 and returns 
*s1. If *s1 and *s2 overlap 
the result is undefined. 


Same as memcpy, but 
overlapping strings are 
handled correctly. Returns 
*sT. 


Copies *s2 into *s1 and 
returns *s1. If *s1 and *s2 
overlap the result is 
undefined. 


Copies not more than n 
characters from *s2 into 
*s1 and returns *s1. If *s1 
and *s2 overlap the result 
is undefined. 


Appends a copy of *s2 to 

*s1 and returns *s1. lf *s1 
and *s2 overlap the result 
is undefined. 


Appends not more than n 
characters from *s2 to *s1 
and returns *s1. If *s1 and 
*s2 overlap the result is 
undefined. 


Libraries 
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Comparison functions 


Stdio.h 


Wchar.h 


Description 


memcmp(*sl, 
*s2,n) 


strcmp(*sl,*s2) 


strncmp(*sl, 
*s2,n) 


strcoll(*sl,*s2) 


strxfrm(*sl, 
*s2,n) 


wmemcmp(*sl, 
*s2,n) 


wcscmp(*sl,*s2) 


wcsncmp(*sl, 
*s2,n) 


wcscoll(*sl1,*s2) 


wcsxfrm(*sl, 
*s2,n) 


Compares the first n 
characters of *s1 to the first 
n characters of *s2. Returns 
< Oif*s? <*s2, Oif*s? == 
*s2, or > O if *S1 > *s2. 


Compares string *s7 to *s2. 
Returns < 0 if *s1 < *s2, O if 
*s1 = = *s2, or > Oif *s7 > 
*s2. 


Compares the first n 
characters of *s7 to the first 
n characters of *s2. Returns 
< Oif*s? < *s2, Oif*s? == 
*s2, or > O if *S1 > *s2. 


Performs a local-specific 
comparison between string 
*s1 and string *s2 according 
to the LC COLLATE 
category of the current 
locale. Returns < 0 if *s1 < 
*s2, 0 if *s? = = *s2, or > Q if 
*s1 > *s2. (See section 
2.2.12, locale.h) 


Transforms (a local) string 
*s2 so that a comparison 
between transformed strings 
with strcmp gives the same 
result as a comparison 
between non-transformed 
strings with strcoll. 
Returns the transformed 
string *s1. 
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Search functions 


Stdio.h 


Wchar.h 


Description 


memchr(*s,c,n) 


strchr(*s,c) 


strrchr(*s,c) 


strspn(*s,*set) 


strcspn(*s,*set) 


strpbrk(*s,*set) 


strstr(*s,*sub) 


strtok(*s,*dlm) 


wmemchr(*s,c,n) 


wcschr(*s,c) 


wcsrchr(*s,c) 


wcsspn(*s,*set) 


wcscspn(*s,*set) 


wcspbrk(*s,*set) 


wcsstr(*s,*sub) 


wcstok(*s,*dlm) 


Checks the first n characters 
of *s on the occurence of 
character c. Returns a 
pointer to the found 
character. 


Returns a pointer to the first 
occurence of character c in 
*s or the null pointer if not 
found. 


Returns a pointer to the last 
occurence of character c in 
*s or the null pointer if not 
found. 


Searches *s for a seguence 
of characters specified in 
*set. Returns the length of 
the first seguence found. 


Searches *s for a seguence 
of characters not specified in 
*set. Returns the length of 
the first seguence found. 


Same as strspn/wcsspn 
but returns a pointer to the 
first character in *s that also 
is specified in *set. 


Searches for a substring 
*sub in *s. Returns a pointer 
to the first occurence of *sub 
in *s. 


A seguence of calls to this 
function breaks the string *s 
into a seguence of tokens 
delimited by a character 
specified in *dlm. The token 
found in *s is terminated with 
a null character. Returns a 
pointer to the first position in 
*s of the token. 


Libraries 2-41 


Miscellaneous functions 


Stdio.h Wchar.h Description 

memset(*s,c,n) wmemset(*s,c,n) Fills the first n bytes of *s 
with character c and returns 
*S. 

strerror(errno) - Typically, the values for err- 


no come from int errno. 
This function returns a point- 
er to the associated error 
message. (See also section 
2.2.4, errno.h) 


strlen(*s) wcslen(*s) Returns the length of string 
* 
S. 


2.2.23 TIME.H AND WCHAR.H 


The header file time.h provides facilities to retrieve and use the 
(calendar) date and time, and the process time. Time can be represented 
as an integer value, or can be broken-down in components. Two 
arithmetic data types are defined which are capable of holding the integer 
representation of times: 


clock t unsigned long long 
time t unsigned long 


The type struct tm below is defined according to ISO/IEC9899 with one 
exception: this implementation does not support leap seconds. The 
struct tm type is defines as follows: 


struct tm 


{ 


int tm sec; /* seconds after the minute - [0, 59] */ 
int tm min; /* minutes after the hour - [0, 59] */ 
int tm hour; /* hours since midnight - [0, 23] */ 
int tm mday; /* day of the month - [1, 31] */ 
int tm mon; /* months since January - [0, 11] */ 
int tm year; /* year since 1900 */ 
int tm wday; /* days since Sunday - [0, 6] */ 
int tm yday; /* days since January 1 - [0, 365] * 
int tm isdst; /* Daylight Saving Time flag */ 
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Time manipulation 


clock Returns the application's best approximation to 
the processor time used by the program since it 
was started. This low-level routine is not 
implemented because it strongly depends on the 
hardware. To determine the time in seconds, the 
result of clock should be divided by the value 
defined as 


CLOCKS PER SEC 12000000 
difftime(t1,t0) Returns the difference t1-t0 in seconds. 


mktime(tm *tp) Converts the broken-down time in the structure 
pointed to by tp, to a value of type time_t. The 
return value has the same encoding as the return 
value of the time function. 


time (*timer) Returns the current calendar time. This value is 
also assigned to *timer. 


Time conversion 


asctime(tm *tp) Converts the broken-down time in the structure 
pointed to by tp into a string in the form Mon Jan 
21 16:15:14 2004\n\0. Returns a pointer to 
this string. 


ctime(*timer) Converts the calender time pointed to by timer to 
local time in the form of a string. This is equivalent 
to: asctime(localtime(timer) ) 


gmtime(*timer) Converts the calender time pointed to by timer to 
the broken-down time, expressed as UTC. 
Returns a pointer to the broken-down time. 


localtime(*timer) Converts the calendar time pointed to by timer to 
the broken-down time, expressed as local time. 
Returns a pointer to the broken-down time. 


Libraries 


Formatted time 


The next function has a parallel function defined in wchar.h: 


Stdio.h Wchar.h 


strftime(*s,smax,*fmt,tm *tp) wstrftime(*s,smax,*fmt,tm *tp) 


Formats date and time information from struct tm “fp into *s according 
to the specified format *fmt. No more than smax characters are placed into 
*s. The formatting of strftime is locale-specific using the LC_TIME 
category (see section 2.2.12, locale.b). You can use the next conversion 


specifiers: 

%a _ abbreviated weekday name 

%A full weekday name 

96b abbreviated month name 

96B full month name 

96c _ local date and time representation 
%d day of the month (01-31) 

%H hour, 24-hour clock (00-23) 

%I _ hour, 12-hour clock (01-12) 

96 day of the year (001-366) 

2m month (01-12) 

%M minute (00-59) 

%p _ local equivalent of AM or PM 

%S _ second (00-59) 

%U week number of the year, Sunday as first day of the week (00-53) 
%w weekday (0-6, Sunday is 0) 

%W week number of the year, Monday as first day of the week (00-53) 
%x local date representation 

%X local time representation 

%y year without century (00-99) 

%Y _ year with century 

%Z time zone name, if any 


2696 
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The file unistd.h contains standard UNIX I/O functions. These functions 
are all implemented using CrossView Pro's file system simulation. This 
header file is not defined in ISO/IEC9899. 


access (*name,mode) 


chdir(*path) 


close(fd) 


getcwd(*buf,size) 


lseek(fd,offset, 
whence) 


read(fd,*buff,cnt) 


stat(*name,*buff) 


unlink(*name) 


write(fd,*buff,cnt) 


Use the file system simulation of CrossView Pro 
to check the permissions of a file on the host. 
mode specifies the type of access and is a bit 
pattern constructed by a logical OR of the 
following values: 


R_OK Checks read permission. 

W_OK Checks write permission. 

X_OK Checks execute (Search) permission. 
F_OK Checks to see if the file exists. 


(FSS implementation) 


Use the file system simulation feature of 
CrossView Pro to change the current directory 
on the host to the directory indicated by path. 
(FSS implementation) 


File close function. The given file descriptor 
should be properly closed. This function calls 
_close(). (FSS implementation) 


Use the file system simulation feature of 
CrossView Pro to retrieve the current directory 
on the host. Returns the directory name. (FSS 
implementation) 


Moves read-write file offset. Calls _1seek( ). 
(FSS implementation) 


Reads a sequence of characters from a file. This 
function calls _ read ( ). (FSS implementation) 


Use the file system simulation feature of 
CrossView Pro to stat() a file on the host 
platform. (FSS implementation) 


Removes the named file, so that a subseguent 
attempt to open it fails. Calls_unlink(). 
(FSS implementation) 


Write a seguence of characters to a file. 
Calls _write(). (FSS implementation) 
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2.2.25 WCHAR.H 


Many functions in wchar .h represent the wide-character variant of other 
functions so these are discussed together. (See sections 2.2.20, stdio.h, 
2.2.21, stdlib.h, 2.2.22, strings.b and 2.2.23, time.h). 


The remaining functions are described below. They perform conversions 
between multi—-byte characters and wide characters. In these functions, ps 
points to struct mbstate_t which holds the conversion state information 
necessary to convert between seguences of multibyte characters and wide 
characters: 


typedef struct 
{ 


wchar_t wc_value; /* wide character value solved 
so far */ 

unsigned short n bytes; /* number of bytes of solved 
multibyte */ 

unsigned short encoding; /* encoding rule for wide 


character <-> multibyte 
conversion */ 
} mbstate_t; 


When multibyte characters larger than 1 byte are used, this struct will be 
used to store the conversion information when not all the bytes of a 
particular multibyte character have been read from the source. In this 
implementation, multi-byte characters are 1 byte long (MB CUR MAX and 
MB_ LEN MAX are defined as 1) and this will never occur. 


mbsinit(*ps) Determines whether the object pointed to 
by ps, is an initial conversion state. 
Returns a non-zero value if so. 


mbsrtowcs(*pwcs,**src, Restartable version of mbstowcs. See 
n,*ps) section 2.2.21, stdlib.h. The initial 
conversion state is specified by ps. The 
input seguence of multibyte charactersis 
specified indirectly by src. 


wcsrtombs(*s,**src, Restartable version of wcstombs. See 
n,*ps) section 2.2.21, stdlib.h. The initial 
conversion state is specified by ps. The 
input wide string is specified indirectly by 
src. 


mbrtowc(*pwc,*s,n,*ps) Converts a multibyte character *s to a wide 
character *pwc according to conversion 
state ps. See also mbtowc in section 
2.2.21, stdlib. 
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wcrtomb(*s,wc,*ps) 


btowc(c) 


wctob(c) 


mbrlen(*s,n,*ps) 


2.2.26 WCTYPE.H 
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Converts a wide character wc to a 
multi-byte character according to 
conversion state ps and stores the 
multi-byte character in *s. 


Returns the wide character 
corresponding to character c. Returns 
WEOF on error. 


Returns the multi-byte character 
corresponding to the wide character c. 
The returned multi-byte character is 
represented as one byte. Returns EOF 
on error. 


Inspects up to n bytes from the string *s 
to see if those characters represent valid 
multibyte characters, relative to the 
conversion state held in *ps. 


Most functions in wctype.h represent the wide-character variant of 
functions declared in ctype.h and are discussed in section 2.2.3, ctype.h. 
In addition, this header file provides extensible, locale specific functions 
and wide character classification. 


wctype(*property) 


iswctype(wc,desc) 


Constructs a value of type wctype_t that describes 
a class of wide characters identified by the string 
*property. lf property identifies a valid class of wide 
characters according to the LC_ TYPE category (see 
2.2.12, locale.h) of the current locale, a non-zero 
value is returned that can be used as an argument 
in the iswctype function. 


Tests whether the wide character wc is a member of 
the class represented by wctype_t desc. Returns a 
non-zero value if tested true. 


Function Equivalent to locale specific test 
iswalnum(wc) iswctype(wc,wctype(”alnum”)) 
iswalpha(wc) iswctype(wc,wctype(”alpha”)) 
iswcntrl(wc) iswctype(wc,wctype(”cntrl”)) 
iswdigit(wc) iswctype(wc,wctype(”digit”)) 


iswgraph(wc) iswctype(wc,wctype(”graph”)) 
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Function 


Eguivalent to locale specific test 


iswlower(wc) 
iswprint(wc) 
iswpunct(wc) 
iswspace(wc) 
iswupper(wc) 


iswxditig(wc) 


iswctype(wc,wctype(” lower”) ) 
iswctype(wc,wctype(”print”)) 
iswctype(wc,wctype(”punct”)) 
iswctype(wc,wctype(”space”)) 
iswctype(wc,wctype(”upper”)) 


iswctype(wc,wctype("”xdigit”)) 


wctrans(*property) Constructs a value of type wctype_t that describes 


a mapping between wide characters identified by the 
string *property. If property identifies a valid mapping 
of wide characters according to the LC TYPE 
category (see 2.2.12, locale.h) of the current locale, 
a non-zero value is returned that can be used as an 
argument in the towctrans function. 


towctrans(wc,desc) Transforms wide character wc into another 


Function 


wide-character, described by desc. 


Eguivalent to locale specific transformation 


towlower(wc) 


towupper(wc) 


towctrans(wc,wctrans(”“tolower”) 


towctrans(wc,wctrans(”“toupper”) 
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2.3_ C LIBRARY REENTRANCY 


Some of the functions in the C library are reentrant, others are not. The 
table below shows the functions in the C library, and whether they are 
reentrant or not. A dash means that the function is reentrant. Note that 
some of the functions are not reentrant because they set the global 
variable 'errno' (or call other functions that eventually set ’errno’). If your 
program does not check this variable and errno is the only reason for the 
function not being reentrant, these functions can be assumed reentrant as 


well. 


The explanation of the cause why a function is not reentrant sometimes 
refers to a footnote because the explanation is to lengthy for the table. 


Function 


Not reentrant because 


_close 
_doflt 
_doprint 
_doscan 
_Exit 
_filbuf 
_flsbuf 
_getflt 


_iob 


_ioread 


_iowrite 


_lseek 


_open 


_read 


Uses global File System Simulation buffer, 
fss_buffer 


Uses I/O functions which modify iob[]. 
See (1). 


Uses indirect access to static iob[] array. 
See (1). 


Uses indirect access to iob[] and calls un- 
getc (access to local static ungetc[] buffer). 
See (1). 


See exit. 

Uses iob[]. See (1). 

Uses iob[]. See (1). 

Uses iob[]. See (1). 
Defines static iob[]. See (1). 


Depends on low level I/O implementation. 
Uses iob[]. See (1). 


Depends on low level I/O implementation. 
Uses iob[]. See (1). 


Uses global File System Simulation buffer, 
_fss_buffer 


Uses global File System Simulation buffer, 
_fss_buffer 


Uses global File System Simulation buffer, 
_fss_buffer 
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Function Not reentrant because 

_unlink Uses global File System Simulation buffer, 
_ fss_buffer 

_write Uses global File System Simulation buffer, 
_ fss_buffer 

abort Calls exit 

abs labs llabs - 

access Uses global File System Simulation buffer, 
_fss_buffer 

acos acosf acosl Sets errno. 

acosh acoshf acoshl Sets errno via calls to other functions. 

asctime asctime defines static array for broken- 
down time string. 

asin asinf asinl Sets errno. 

asinh asinhf asinhl Sets errno via calls to other functions. 

atan atanf atanl - 

atan2 atan2f atan21 - 

atanh atanhf atanhl Sets errno via calls to other functions. 

atexit atexit defines static array with function 
pointers to execute at exit of program. 

atof - 

atoi - 

atol - 

bsearch - 

btowc - 

cabs cabsf cabsl Sets errno via calls to other functions. 

cacos cacosf cacosl Sets errno via calls to other functions. 

cacosh cacosh cfacoshl Sets errno via calls to other functions. 

calloc calloc uses static buffer management 
structures. See malloc (5). 

carg cargf cargl = 

casin casinf casinl Sets errno via calls to other functions. 

casinh casinh cfasinhl Sets errno via calls to other functions. 

catan catanf catanl Sets errno via calls to other functions. 
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Not reentrant because 


catanh catanhf catanhl 
cbrt cbrtf cbrtl 
ccos ccosf ccosl 
ccosh ccoshf ccoshl 
ceil ceilf ceill 
cexp cexpf cexpl 


chdir 


cimag cimagf cimagl 
cleanup 

clearerr 

clock 

clog clogf clogl 
close 

conj conjf conjl 


copysign copysignf 
copysignl 


cos cosf cosl 


cosh coshf coshl 


cpow cpowf cpowl 
cproj cprojf cprojl 


creal crealf creall 


csin csinf csinl 
csinh csinhf csinhl 
csgrt csgrtf csgrtl 
ctan ctanf ctanl 
ctanh ctanhf ctanhl 
ctime 

difftime 

div ldiv lldiv 
erf erfl erff 


Sets errno via calls to other functions. 
(Not implemented) 

Sets errno via calls to other functions. 
Sets errno via calls to other functions. 
Sets errno via calls to other functions. 


Uses global File System Simulation buffer, 
fss_buffer 


Calls fclose. See (1) 
Modifies iob[]. See (1) 
Sets errno via calls to other functions. 


Calls _ close 


cosh calls exp(), which sets errno. If errno 
is discarded, cosh is reentrant. 


Sets errno via calls to other functions. 


Sets errno via calls to other functions. 
Sets errno via calls to other functions. 
Sets errno via calls to other functions. 
Sets errno via calls to other functions. 
Sets errno via calls to other functions. 


Calls asctime 


(Not implemented) 
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erfc erfcf erfcl (Not implemented) 

exit Calls fclose indirectly which uses iob[] 
calls functions in _ atexit array. See (1). 
To make exit reentrant kernel support is 
reguired. 

exp expf expl Sets errno. 

exp2  exp2f  exp2l (Not implemented) 

expml expmlf expmll (Not implemented) 

fabs fabsf fabsl - 

fclose Uses values in iob[]. See (1). 

fdim fdimf — fdiml (Not implemented) 

feclearexcept (Not implemented) 

fegetenv (Not implemented) 

fegetexceptflag (Not implemented) 

fegetround (Not implemented) 

feholdexept (Not implemented) 

feof Uses values in iob[]. See (1). 

feraiseexcept (Not implemented) 

ferror Uses values in iob[]. See (1). 

fesetenv (Not implemented) 

fesetexceptflag (Not implemented) 

fesetround (Not implemented) 

fetestexcept (Not implemented) 

feupdateenv (Not implemented) 

fflush Modifies iob[]. See (1). 

fgetc fgetwc Uses pointer to iob[]. See (1). 

fgetpos Sets the variable errno and uses pointer to 
iob[]. See (1) / (2). 

fgets fgetws Uses iob[]. See (1). 

floor floorf floorl - 

fma fmaf fmal (Not implemented) 

fmax fmaxf fmaxl (Not implemented) 

fmin fminf fminl (Not implemented) 
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Function Not reentrant because 

fmod fmodf fmodl - 

fopen Uses iob[] and calls malloc when file open 
for buffered IO. See (1) 

fpclassify - 

fprintf fwprintf Uses iob[]. See (1). 

fputc — fputwc Uses iob[]. See (1). 

fputs fputws Uses iob[]. See (1). 

fread Calls fgetc. See (1). 

free free uses static buffer management struc- 
tures. See malloc (5). 

freopen Modifies iob[]. See (1). 

frexp frexpf frexpl = 

fscanf fwscanf Uses iob[]. See (1) 

fseek Uses iob[] and calls _ doscan. 
Acesses ungetc[] array. See (1). 

fsetpos Uses iob[] and sets errno. See (1) / (2). 

ftell Uses iob[] and sets errno. Calls _Iseek. 
See (1) / (2). 

fwrite Uses iob[]. See (1). 

getc getwc Uses iob[]. See (1). 

getchar getwchar Uses iob[]. See (1). 

getcwd Uses global File System Simulation buffer, 
_ fss_buffer 

getenv Skeleton only. 

gets getws Uses iob[]. See (1). 

gmtime gmtime defines static structure 

hypot hypotf hypotl Sets errno via calls to other functions. 

ilogb ilogbf ilogbl (Not implemented) 

imaxabs - 

imaxdiv - 

isalnum iswalnum - 

isalpha iswalpha - 

isascii iswascii - 
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Not reentrant because 


iscntrl iswcntrl 
isdigit iswdigit 
isfinite 

isgraph iswgraph 
isgreater 
isgreateregual 
isinf 

isless 
islessegual 
islessgreater 
islower iswlower 
isnan 

isnormal 

isprint iswprint 
ispunct iswpunct 
isspace iswspace 
isunordered 
isupper iswupper 
iswalnum 

iswalpha 

iswentrl 

iswctype 

iswdigit 

iswgraph 

iswlower 

iswprint 

iswpunct 

iswspace 

iswupper 
iswxditig 


isxdigit iswxdigit 


2-54 


Function 


TriCore Reference Manual 


Not reentrant because 


ldexp ldexpf ldexpl 


llrint lrintf lrintl 


localeconv 

localtime 

log logf logl 
log10 logl0f log10l 
loglp loglpf loglpl 
log2 log2f log2l 
logb logbf logbl 
longjmp 

lrint lrintf lrintl 


lround lroundf lroundl 


lseek 

malloc 

mblen 

mbrlen 

mbrtowc 

mbsinit 
mbsrtowcs 
mbstowcs 

mbtowc 

memchr wmemchr 
memcmp wmemcmp 
memcpy wmemcpy 
memmove wmemmove 
memset wmemset 
mktime 

modf modff modfl 


nan nanf nanl 


lgamma lgammaf lgammal 


llround llroundf llroundl 


Sets errno. See (2). 
(Not implemented) 
(Not implemented) 
(Not implemented) 
N.A.; skeleton function 


Sets errno. See (2). 

Sets errno via calls to other functions. 
(Not implemented) 

(Not implemented) 

(Not implemented) 

(Not implemented) 

(Not implemented) 

Calls _Iseek 

Needs kernel support. See (5). 
N.A., skeleton function 

Sets errno. 

Sets errno. 

Sets errno. 

N.A., skeleton function 

N.A., skeleton function 


(Not implemented) 
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Function Not reentrant because 
nearbyint nearbyintf (Not implemented) 
nearbyintl 
nextafter nextafterf (Not implemented) 
nextafterl 
nexttoward nexttowardf (Not implemented) 
nexttowardl 
offsetof - 
open Calls _open 
perror Uses errno. See (2) 
pow powf powl Sets errno. See (2) 
printf wprintf Uses iob[]. See (1) 
putc putwc Uses iob[]. See (1) 
putchar putwchar Uses iob[]. See (1) 
puts Uses iob[]. See (1) 
gsort = 
raise Updates the signal handler table 
rand Uses static variable to remember latest 


random number. Must diverge from ANSI 
standard to define reentrant rand. See (4). 


read Calls _read 
realloc See malloc (5). 
remainder remainderf (Not implemented) 
remainderl 

remove N.A; skeleton only. 
remquo remguof remguol (Not implemented) 
rename N.A; skeleton only. 
rewind N.A; skeleton only. 
rint rintf rintl (Not implemented) 
round roundf roundl (Not implemented) 


scalbln scalblnf scalblnl - 

scalbn scalbnf scalbnl - 

scanf wscanf Uses iob[], calls _doscan. See (1). 
setbuf Sets iob[]. See (1). 


setjmp - 
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Function Not reentrant because 

setlocale N.A.; skeleton function 

setvbuf Sets iob and calls malloc. See (1) / (5). 

signal Updates the signal handler table 

signbit - 

sin sinf sinl - 

sinh sinhf sinhl Sets errno via calls to other functions. 

snprintf swprintf Sets errno. See (2). 

sprintf Sets errno. See (2). 

sgrt sgrtf sgrtl Sets errno. See (2). 

srand See rand 

sscanf — swscanf Sets errno via calls to other functions. 

stat Uses global File System Simulation buffer, 
_ fss_buffer 

strcat wcscat = 

strchr wcschr = 

strcmp wcscmp aa 

strcoll wcscoll = 

strcpy wcscpy aa 

strcspn wcscspn - 

strerror = 

strftime wstrftime - 

strlen wcslen - 

strncat wcsncat = 

strncmp wcsncmp - 

strncpy wcsncpy - 

strpbrk wcspbrk = 

strrchr wcsrchr = 

strspn wcsspn = 

strstr wcsstr = 

strtod wcstod = 

strtof wcstof = 

strtoimax Sets errno via calls to other functions. 
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Function 


Not reentrant because 


strtok wcstok 


strtol wcstol 
strtold wcstold 
strtoul wcstoul 
strtoull wcstoull 
strtoumax 

strxfrm wcsxfrm 
system 

tan tanf tanl 
tanh tanhf tanhl 
tgamma tgammaf tgammal 


time 


tmpfile 


tmpnam 


toascii 

tolower 

toupper 

towctrans 

towlower 

towupper 

trunc truncf truncl 


ungetc ungetwc 


unlink 
vfprintf vfwprintf 
vfscanf vfwscanf 


vprintf vwprintf 


Strtok saves last position in string in local 
static variable. This function is not 
reentrant by design. See (4). 


Sets errno. See (2). 

Sets errno. See (2). 

Sets errno. See (2). 

Sets errno via calls to other functions. 
N.A; skeleton function 

Sets errno. See (2). 

Sets errno via call to other functions. 
(Not implemented) 


Uses static variable which defines initial 
start time 


Uses iob[]. See (1). 


Uses local buffer to build filename. 
Function can be adapted to use user buff- 
er. This makes the function non ANSI. See 


(4). 


(Not implemented) 


Uses static buffer to hold ungetted charac- 
ters for each file. Can be moved into iob 
structure. See (1). 


Calls _ unlink 
Uses iob[]. See (1). 
Calls doscan 
Uses iob[]. See (1). 
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Function Not reentrant because 

vscanf vwscanf Calls doscan 

vsprintf vswprintf Sets errno. 

vsscanf vswscanf Sets errno. 

wcrtomb Sets errno. 

wcsrtombs Sets errno. 

wcstoimax Sets errno via calls to other functions. 
wcstombs N.A.; skeleton function 

wcstoumax Sets errno via calls to other functions. 
wctob - 

wctomb N.A.; skeleton function 

wctrans = 

wctype = 

write Calls _ write 


Table 2-4: C library reentrancy 


Several functions in the C library are not reentrant due to the following 
reasons: 


The iob[ ] structure is static. This influences all I/O functions. 


The ungetc[ ] array is static. This array holds the characters (one 
for each stream) when ungetc() is called. 


The variable errno is globally defined. Numerous functions read or 
modify errno 


_doprint and _ doscan use static variables for e.g. character 
counting in strings. 


Some string functions use locally defined (static) buffers. This is 
prescribed by ANSI. 


malloc uses a static heap space. 


The following description discusses these items into more detail. The 
numbers at the begin of each paragraph relate to the number references in 
the table above. 


Libraries 2-59 


(1) iob structures 


The I/O part of the C library is not reentrant by design. This is mainly 
caused by the static declaration of the iob[] array. The functions which use 
elements of this array access these elements via pointers (FILE * ). 


Building a multi-process system that is created in one link-run is hard to 
do. The C language scoping rules for external variables make it difficult to 
create a private copy of the iob[ ] array. Currently, the iob[ ] array has 
external scope. Thus it is visible in every module involved in one link 
phase. If these modules comprise several tasks (processes) in a system 
each of which should have its private copy of iob[ ], it is apparent that 
the iob[] declaration should be changed. This requires adaption of the 
library to the multi-tasking environment. The library modules must use a 
process identification as an index for determining which iob[ ] array to 
use. Thus the library is suitable for interfacing to that kernel only. 


Another approach for the iob[ ] declaration problem is to declare the 
array static in one of the modules which create a task. Thus there can be 
more than one iob[ ] array is the system without having conflicts at link 
time. This brings several restrictions: Only the module that holds the 
declaration of the static iob[ ] can use the standard file handles stdin, 
stdout and stderr (which are the first three entries in iob[ ]). Thus all 
I/O for these three file handles should be located in one module. 


(2) errno declaration 


Several functions in the C library set the global variable errno. After 
completion of the function the user program may consult this variable to 
see if some error occurred. Since most of the functions that set errno 
already have a return type (this is the reason for using errno) it is not 
possible to check successful completion via the return type. 


The library routines can set errno to the values defined in errno.h. See 
the file errno.h for more information. 


errno can be set to ERR FORMAT by the print and scan functions in the 
C library if you specify illegal format strings. 


errno will never be set to ERR NOLONG or ERR NOPOINT since the 
Tricore C library supports long and pointer conversion routines for input 
and output. 
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errno can be set to ERANGE by the following functions: exp(), 
strtol(), strtoul() and tan(). These functions may produce results 
that are out of the valid range for the return type. If so, the result of the 
function will be the largest representable value for that type and errno is 
set to ERANGE. 


errno is set to EDOM by the following functions: acos(), asin(), 
log(), pow() and sgrt(). If the arguments for these functions are out of 
their valid range (e.g. sgrt( -1 ) ), errno is set to EDOM. 


errno can be set to ERR_POS by the file positioning functions fte11(), 
fsetpos() and fgetpos(). 


(3) ungetc 


Currently the ungetc buffer is static. For each file entry in the iob[| 
structure array, there is one character available in the buffer to unget a 
character. 


(4) local buffers 


tmpnam( ) creates a temporary filename and returns a pointer to a local 
static buffer. This is according to the ANSI definition. Changing this 
function such that it creates the name in a user specified buffer reguires 
another calling interface. Thus the function would be no longer portable. 


strtok() scans through a string and remembers that the string and the 
position in the string for subseguent calls. This function is not reentrant by 
design. Making it reentrant requires support of a kernel to store the 
information on a per process basis. 


rand() generates a seguence of random numbers. The function uses the 
value returned by a previous call to generate the next value in the 
seguence. This function can be made reentrant by specifying the previous 
random value as one of the arguments. However, then it is no longer a 
standard function. 


(©) malloc 


Malloc uses a heap space which is assigned at locate time. Thus this 
implementation is not reentrant. Making a reentrant malloc requires some 
sort of system call to obtain free memory space on a per process basis. 
This is not easy to solve within the current context of the library. This 
requires adaption to a kernel. 
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This paragraph on reentrancy applies to multi-process environments only. 


If reentrancy is reguired for calling library functions from an exception 
handler, another approach is reguired. For such a situation it is of no use 
to allocate e.g. multiple iob[ ] structures. In such a situation several 
pieces of code in the library have to be declared 'atomic': this means that 
interrupts have to be disabled while executing an atomic piece of code. 
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TRICORE ASSEMBLY 
LANGUAGE 


ail TASKING M 


diLdVHO 


TriCore Assembly Language 


3.1 


INTRODUCTION 


This chapter contains a detailed description of all built-in assembly 
functions directives and controls. For a description of the TriCore 
instruction set, refer to the 7riCore Architecture v1.3 Manual (2000, 
Infineon]. 


3.2 


BUILT-IN ASSEMBLY FUNCTIONS 


3.2.1 


OVERVIEW OF BUILT-IN ASSEMBLY FUNCTIONS 


The built-in assembler functions are grouped into the following types: 


Mathematical functions comprise, among others, transcendental, 
random value, and min/max functions. 


Conversion functions provide conversion between integer, 
floating-point, and fixed point fractional values. 


String functions compare strings, return the length of a string, and 
return the position of a substring within a string. 


Macro functions return information about macros. 


Address calculation functions return the high or low part of an 
address. 


Assembler mode functions relating assembler operation. 


The following tables provide an overview of all built-in assembler 
functions. expr can be any assembly expression resulting in an integer 
value. Expressions are explained in section 4.6, Assembly Expressions, in 
chapter Assembly Language of the User’s Manual. 
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Overview of mathematical functions 


Function Description 
@ABS (expr) Absolute value 
@ACS (expr) Arc cosine 
@ASN(expr) Arc sine 
@AT2(expr1 ,expr2) Arc tangent 
@ATN(expr) Arc tangent 
@CEL(expr) Ceiling function 
@COH (expr) Hyperbolic cosine 
@COS (expr) Cosine 
@FLR(expr) Floor function 
@L10(expr) Log base 10 
@LOG(expr) Natural logarithm 


(OMAX(expr,[,...,exprN]) 
(OMIN(expr,[,...,exprN]) 
(OPOW(expr1 ,expr2) 
@RND() 

@SGN (expr) 
@SIN(expr) 

@SNH (expr) 


Maximum value 

Minimum value 

Raise to a power 

Random value 

Returns the sign of an expression as -1, 0 or 1 
Sine 

Hyperbolic sine 

Square root 

Tangent 

Hyperbolic tangent 

Exponential function (raise e to a power) 


TriCore Assembly Language 


Overview of conversion functions 


Function Description 
@CVF (expr) Convert integer to floating-point 
(oCVI(expr) Convert floating-point to integer 
@FLD (base,value, Shift and mask operation 

width[,start]) 
@FRACT (expr) Convert floating-point to 32-bit fractional 
@SFRACT (expr) Convert floating-point to 16-bit fractional 
(OLNG (expr) Concatenate to double word 
@LUN (expr) Convert long fractional to floating-point 
(ORVB(expr1[,expr2]) Reverse order of bits in field 
@UNF (expr) Convert fractional to floating-point 


Overview of string functions 


@POS(sir1 ,str2[,start]) 
@SCP(sir1 ,str2) 
@SUB(string,expr,expr) 


Function Description 
@CAT (sir1 ,str2) Concatenate strings 
(OLEN (string) Length of string 


Position of substring in string 
Returns 1 if two strings are egual 
Returns a substring 


Overview of macro functions 


Function Description 

(OARG(symbol'|expr) Test if macro argument is present 
(oCNT() Return number of macro arguments 
(OMAC(symbol) Test if macro is defined 

@MXP() Test if macro expansion is active 
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Overview of address calculation functions 


Function Description 

@DPTR(expr) PCP only: returns bits 6-13 of the pcpdata 
address 

@HI (expr) Returns upper 16 bits of expression value 

@HIS(expr) Returns upper 16 bits of expression value, 


adjusted for signed addition 
@INIT_R7(start,dptr,flags) PCP only: returns the 32-bit value to initialize 


R7 
@LO(expr) Returns lower 16 bits of expression value 
@LOS (expr) Returns lower 16 bits of expression value, 
adjusted for signed addition 
(OLSB(expr) Get least significant byte of a word 
@MSB(expr) Get most significant byte of a word 


Overview of assembler mode functions 


Function Description 

@ASPCP\() Returns the name of the PCP assembler 
executable 

@ASTC() Returns the name of the assembler executable 

@CPU(siring) Test if CPU type is selected 

@DEF (‘symbol |symbol) Returns 1 if symbol has been defined 

@EXP (expr) Expression check 

(OINT (expr) Integer check 

@LST() LIST control flag value 


3.2.2 DETAILED DESCRIPTION OF BUILT-IN 
ASSEMBLY FUNCTIONS 


@ABS (expression) 


Returns the absolute value of expression as an integer value. 
Example: 


AVAL .SET @ABS(-2.1)  ; AVAL = 2 
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@ACS(expression) 


Returns the arc cosine of expression as a floating-point value in the range 
zero to pi. The result of expression must be between -1 and 1. 


Example: 


ACOS .SET @ACS(-1.0) ;ACOS = 3.1415926535897931 


(OARG('symbol” | expression) 


Returns an integer 1 if the macro argument represented by symbol or 
expression is present, 0 otherwise. If the argument is a symbol it must be 
single-guoted and refer to a formal argument name. If the argument is an 
expression it refers to the ordinal position of the argument in the macro 
formal argument list. The assembler issues a warning if this function is 
used when no macro expansion is active. 


Example: 
.IF GARG('TWIDDLE') ;twiddle factor provided? 
.IF @ARG(1) ;is first argument present? 
@ASN (expression) 


Returns the arc sine of expression as a floating-point value in the range 
-pi/2 to pi/2. The result of expression must be between -1 and 1. 


Example: 
ARCSINE -SET @ASN(-1.0) ;ARCSINE = -1.570796 


GASPCP() 


Returns the name of the PCP assembler executable. This is 'aspcp' for the 
PCP assembler. 


Example: 
ANAME: -byte @ASPCP() ; ANAME = 'aspcp' 


GASTC() 


Returns the name of the assembler executable. This is ’astc’ for the TriCore 
assembler. 


Example: 


ANAME: .byte @ASTC() ; ANAME = 'astc' 
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(OAT2(expr1,expr2) 


Returns the arc tangent of expr1/expr2 as a floating-point value in the 
range -pi to pi. Expr7 and expr2 must be separated by a comma. 


Example: 
ATAN2 .EOU @AT2(-1.0,1.0) ;ATAN2 = -0.7853982 
(OATN (expression) 


Returns the arc tangent of expression as a floating-point value in the range 
-pi/2 to pi/2. 


Example: 
ATAN .SET @ATN(1.0) ;ATAN = 0.78539816339744828 


@CAT(string1 ,string2) 


Concatenates the two strings into one string. The two strings must be 
enclosed in single or double quotes. 


Example: 
-DEFINE ID “"@CAT(’Tri’,’Core’)” ;ID = 'TriCore' 


(CEL (expression) 


Returns a floating-point value which represents the smallest integer greater 
than or egual to expression. 


Example: 
CEIL .SET @CEL(-1.05) ;CEIL = -1.0 


GCNT() 


Returns the number of arguments of the current macro expansion as an 
integer. The assembler issues a warning if this function is used when no 
macro expansion is active. 


Example: 


ARGCNT .SET @CNT() ;reserve argument count 
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@COH (expression) 


Returns the hyperbolic cosine of expression as a floating-point value. 


Example: 
HYCOS .EOU @COH(VAL) ;compute hyperbolic cosine 
@COS (expression) 


Returns the cosine of expression as a floating-point value. 
Example: 
-WORD -@COS(@CVF(COUNT)*FREQ) ;compute cosine value 


@CPU (string) 


Returns an integer 1 if string corresponds to the selected CPU type; 0 
otherwise. See also the assembler option -C (Select CPU). 


Example: 


IF @CPU("tc2") ;TriCore 2 specific part 


(0CVF (expression) 


Converts the result of expression to a floating-point value. 


Example: 
FLOAT .SET @CVF(5) ;FLOAT = 5.0 
@CVI (expression) 


Converts the result of expression to an integer value. This function should 
be used with caution since the conversions can be inexact (e.g., 
floating-point values are truncated). 


Example: 


INT .SET @CVI(-1.05) ;INT = -1 
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@DEF(‘symbol’ | symbol) 
Returns an integer 1 if symbo/ has been defined, 0 otherwise. symbol can 
be any symbol or label not associated with a . MACRO or . SDECL directive. 
If symbol is quoted it is looked up as a .DEFINE symbol; if it is not 
guoted it is looked up as an ordinary symbol or label. 


Example: 
.IF GDEF('ANGLE') ;is symbol ANGLE defined? 
.IF @DEF(ANGLE) ;does label ANGLE exist? 
@DPTR (expression) 


PCP assembler only. Returns bits 6-13 of the pcpdata address provided. 
This is equivalent to ((expression>>6) & Oxff). 


Example: 
ldl.il r7,@DPTR(pcp data a0) 


(OEXP (expression) 


Returns 0 if the evaluation of expression would normally result in an error. 
Returns 1 if the expression can be evaluated correctly. With the @EXP 
function, you prevent the assembler of generating an error if expression 
contains an error. No test is made by the assembler for warnings. The 
expression may be relative or absolute. 


Example: 


.IF !@EXP(3/0) ;Do the IF on error 
;assembler generates no error 


.IF !(3/0) ;assembler generates an error 
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GOFLD(basevalue,widtb[,start]) 


Shift and mask value into base for width bits beginning at bit start. If start 
is omitted, zero (least significant bit) is assumed. All arguments must be 
positive integers and none may be greater than the target word size. 
Returns the shifted and masked value. 


Example: 


VAR1 .EOU @FLD(0,1,1) ;turn bit 0 on, VAR1-1 

VAR2 .EOU @FLD(0,3,1) ;turn bit 0 on, VAR2=1 

VAR3 .EOU @FLD(0,3,2) ;turn bits 0 and 1 on, VAR3=3 

VAR4 .EOU @FLD(0,3,2,1) ;turn bits 1 and 2 on, VAR4=6 

VAR5 .EOU @FLD(0,1,1,7) ;turn eighth bit on, VAR5-0x80 


@FLR (expression) 


Returns a floating-point value which represents the largest integer less 
than or egual to expression. 


Example: 
FLOOR SET @FLR(2.5) ;FLOOR = 2.0 
@FRACT (expression) 


This function returns the 32-bit fractional representation of the 
floating-point expression. The expression must be in the range [-1,+1>. 


Example: 
WORD @FRACT(0.1), @FRACT(1.0) 


(HI (expression) 


Returns the upper 16 bits of a value. 8HI (expression) is equivalent to 
((expression>>l6) & Oxffff). 


Example: 


mov.u d2,#@LO(COUNT) 
addih d2,d2,#@HI (COUNT) ; upper 16 bits of COUNT 


3-12 TriCore Reference Manual 


- 


@HIS (expression) 


Returns the upper 16 bits of a value, adjusted for a signed addition. 
@HIS (expression) is equivalent to (((expression+0x800)>>16) & 
Oxffff). 


Example: 


movh.a a3,#@HIS(label) 
lea a3,[a3]@LOS(label) 


@INIT_R7(start,dptr, flags) 


PCP assembler only. Returns the 32-bit value needed to initialize R7. This 
is equivalent to (start<<16) + (((dptr&0x3fff)>>6)<<8) + 
(flags & Oxff). 


Example: 
.word @init r7(start_0,pcp data_0,7) 


@INT (expression) 


Returns an integer 1 if expression has an integer result; otherwise, it 
returns a 0. The expression may be relative or absolute. 


Example: 
.IF @INT(TERM) ;Test if result is an integer 


@L10(expression) 


Returns the base 10 logarithm of expression as a floating-point value. 
expression must be greater than zero. 


Example: 
LOG .EOU @L10(100.0) ;LOG = 2 
@LEN(string) 
Returns the length of string as an integer. 
Example: 
SLEN .SET @LEN(‘’string’) ;SLEN = 6 
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(OLNG(expr1,expr2) 


Concatenates the 16-bit expr/ and expr2 into a 32-bit word value such 
that expr7 is the high half and expr2 is the low half. 


Example: 
LWORD .WORD 6GLNG(HI,LO) ;build long word 


@LO(expression) 


Returns the lower 16 bits of a value. @LO(expression) is equivalent to 
expression & Oxffff). 


Example: 


mov.u d2,#@LO(COUNT) ;lower 16 bits of COUNT 
addih d2,d2,#@HI(COUNT) 


(LOG (expression) 


Returns the natural logarithm of expression as a floating-point value. 
expression must be greater than zero. 


Example: 
LOG .EOU @LOG(100.0) ;LOG = 4.605170 
@LOS (expression) 


Returns the lower 16 bits of a value, adjusted for a signed addition. 
@LOS (expression) is equivalent to (((expression+0x8000) & 
Oxffff) - 0x8000). 


Example: 


movh.a a3,#@HIS(label) 
lea a3,[a3]@LOS(label) 
@LSB (expression) 


Returns the least significant byte of the result of the expression. 
expression is interpreted as a half word (16 bit). 


Example: 
VAR1  .SET @LSB(0x34) ;VAR1 = 0x34 
VAR2 .SET @LSB(0x1234) ;VAR2 = 0x34 
VAR3 — .SET @LSB(0x654321) ;VAR3 = 0x21 
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GLST() 


Returns the value of the $LIST ON/OFF control flag as an integer. 
Whenever a $LIST ON control is encountered in the assembler source, the 
flag is incremented; when a $LIST OFF control is encountered, the flag is 
decremented. 


Example: 
.DUP @ABS (@LST() ) ;list unconditionally 


@LUN (expression) 


Converts the 32-bit expression to a floating-point value. expression should 
represent a binary fraction. 


Example: 
DBLFRC1 .EOU @LUN(0x40000000) ;DBLFRC1 = 0.5 
DBLFRC2 .EOU @LUN(3928472) ;DBLFRC2 = 0.007354736 
DBLFRC3 .EOU @LUN(0xE0000000) ;DBLFRC3 = -0.75 
@MAC(symbol) 
Returns an integer 1 if symbol has been defined as a macro name, 0 
otherwise. 
Example: 
IF @MAC ( DOMUL) ;does macro DOMUL exist? 


OMAX (expr1[,exprN]...) 


Returns the greatest of expr7 ,...,exprN as a floating-point value. 
Example: 
MAX: .BYTE @MAX(1,-2.137,3.5) ;MAX = 3.5 
(MIN (expr 1[,exprN]...) 
Returns the least of expr ,...,exprN as a floating-point value. 
Example: 


MIN: .BYTE @MIN(1,-2.137,3.5)  ;MIN = -2.137 
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(OM SB (expression) 


Returns the most significant byte of the result of the expression. 
expression is interpreted as a half word (16 bit). 


Example: 
VAR1 .SET @MSB(0x34) ;VAR1 = 0x00 
VAR2 — .SET @MSB(0x1234) ;VAR2 = 0x12 
VAR3 .SET @MSB(0x654321) ;VAR3 = 0x43 
GMXP() 


Returns an integer 1 if the assembler is expanding a macro, 0 otherwise. 


Example: 


.IF @MXP() ;macro expansion active? 


@POS(str1,str2[,start]) 


Returns the position of str2 in sir as an integer, starting at position start. If 
start is not given the search begins at the beginning of str1. If the start 
argument is specified it must be a positive integer and cannot exceed the 
length of the source string. Note that the first position in a string is 


position 0. 
Example: 
ID .EOU GPOS('TriCore','Core') ;ID = 3 
ID2 .EOU @POS(’ABCDABCD’,'B’,2) ;ID2 = 5 
@POW (expr Lexpr2) 


Returns expr/ raised to the power expr2 as a floating-point value. expr 1 
and expr2 must be separated by a comma. 


Example: 


BUF .EOU @CVI(@POW(2.0,3.0)) ;BUF = 8 


@RNDQ 
Returns a random value in the range 0.0 to 1.0. 


Example: 


SEED .EQU @RND() ;save initial SEED value 


3-15 


3-16 TriCore Reference Manual 


- 


@RVB(expr1,expr2) 


Reverse the order of bits in expr1 delimited by the number of bits in 
expr2. If expr2 is omitted the field is bounded by the target word size. 
Both expressions must be 16-bit integer values. 


Example: 


VAR1 .SET @RVB(0x200) ;reverse all bits, VAR1=0x40 

VAR2 .SET @RVB(0xBO02) ;reverse all bits, VAR2-0x40D0 

VAR3 .SET @RVB(0xB02,2) ;reverse bits 0 and 1, 
;VAR3=0xB01 


@SCP(str1,str2) 


Returns an integer 1 if the two strings compare, 0 otherwise. The two 
strings must be separated by a comma. 


Example: 
.IF GSCP(STR,'MAIN”') ;does STR egual MAIN? 
@SFRACT (expression) 


This function returns the 16-bit fractional representation of the 
floating-point expression. The expression must be in the range [-1,+1>. 


Example: 


WORD @SFRACT(0.1), @SFRACT(1.0) 


@SGN (expression) 


Returns the sign of expression as an integer: —1 if the argument is negative, 
0 if zero, 1 if positive. The expression may be relative or absolute. 


Example: 
VAR1 .SET @SGN(-1.2e-92) ;VARI = -1 
VAR2 .SET @SGN(0) ;VAR2 = 0 
VAR3 .SET @SGN(28.382) ;VAR3 = 1 
(SIN (expression) 


Returns the sine of expression as a floating-point value. 
Example: 


. WORD @SIN( @CVF (COUNT ) *FREQ) ;compute sine value 
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@SNH (expression) 


Returns the hyperbolic sine of expression as a floating-point value. 


Example: 
HSINE .EOU @SNH(VAL) ;hyperbolic sine 
@SQT (expression) 


Returns the square root of expression as a floating-point value. expression 
must be positive. 


Example: 
SORT1 .EQU @SQT(3.5) ;SORT1 = 1.870829 
SORT2 .EOU @SQT(16) ;SORT2 = 4 


@SUB(string,expression 1,expression2) 


Returns the substring from string as a string. Expression is the starting 
position within string, and expression? is the length of the desired string. 
The assembler issues an error if either expression 1 or expression2 exceeds 
the length of string. Note that the first position in a string is position 0. 


Example: 


-DEFINE ID "@SUB(’TriCore’,3,4)" ;ID = ‘Core’ 


(TAN (expression) 
Returns the tangent of expression as a floating-point value. 
Example: 
TANGENT .SET @TAN(1.0) ; TANGENT = 1.5574077 
@TNH (expression) 
Returns the hyperbolic tangent of expression as a floating-point value. 
Example: 


HTAN .SET @TNH(1) ;HTAN = 0.76159415595 
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@UNF (expression) 


Converts expression to a floating-point value. expression should represent 
a 16-bit binary fraction. 


Example: 
FRC .EOU @UNF(0x4000) ;FRC = 0.5 
@XPN(expression) 


Returns the exponential function (base e raised to the power of 
expression) as a floating-point value. 


Example: 


EXP .EQU @XPN(1.0) ;EXP = 2.718282 


TriCore Assembly Language 
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ASSEMBLER DIRECTIVES AND CONTROLS 


3.3. 


1 OVERVIEW OF ASSEMBLER DIRECTIVES 


Assembler directives are grouped in the following categories: 


Assembly control directives 

Symbol definition directives 

Data definition / Storage allocation directives 
Macro and conditional assembly directives 
Debug directives 


The following tables provide an overview of all assembler directives. 


Overview of assembly control directives 


Directive Description 

-COMMENT Start comment lines 

.DEFINE Define substitution string 

.END End of source program 

.FAIL Programmer generated error message 

INCLUDE Include file 

.MESSAGE Programmer generated message 

.ORG Initialize memory space and location counters to 
create a nameless section 

.SDECL Declare a section with name, type and attributes 

.SECT Activate a declared section 

.UNDEF Undefine DEFINE symbol 


.WARNING Programmer generated warning 
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Overview of symbol definition directives 


Directive Description 

-EQU Assign permanent value to a symbol 
.EXTERN External symbol declaration 

.GLOBAL Global section symbol declaration 

.LOCAL Local symbol declaration 

.SET Set temporary value to a symbol 

.SIZE Set size of symbol in the ELF symbol table 
.TYPE Set symbol type in the ELF symbol table 
.WEAK Mark symbol as ‘weak’ 


Overview of data definition / storage allocation directives 


-FLOAT / .DOUBLE 
-FRACT / .SFRACT 
.SPACE 

.WORD / .HALF 


Directive Description 

.ACCUM Define 64-bit constant of 18 + 46 bits format 
ALIGN Define alignment 

ASCII / .ASCIIZ Define ASCII string without / with ending NULL byte 
.BYTE Define constant byte (not for PCP) 


Define a 32-bit / 64-bit floating-point constant 
Define a 16-bit / 32-bit constant fraction 

Define storage 

Define a word / half-word constant (not for PCP) 
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Overview of macro and conditional assembly directives 


Directive Description 

.DUP / .ENDM Duplicate seguence of source lines 
.DUPA / .ENDM Duplicate seguence with arguments 
.DUPC / .ENDM Duplicate seguence with characters 
.DUPF / .ENDM Duplicate seguence in loop 

.EXITM Exit macro 

IF /.ELIF / .ELSE / Conditional assembly 

.ENDIF 

.MACRO / .ENDM Define macro 

.PMACRO Undefine (purge) macro definition 


Overview of debug directives 


Function Description 


.CALLS Passes call information to object file. Used by the 


linker to build a call graph and calculate stack size. 


3.3.2 DETAILED DESCRIPTION OF ASSEMBLER 
DIRECTIVES 


Some assembler directives can be preceeded with a label. If you do not 
preceede an assembler directive with a label, you must use white space 
instead (spaces or tabs). The assembler recognizes both upper and lower 
case for directives. 


3-21 


3-22 TriCore Reference Manual 


— 
.ACCUM 


Syntax 
llabel:) .ACCUM expression| expression]... 


Description 


With the . ACCUM directive (Define 64-bit Constant) the assembler allocates 
and initializes two words of memory (64 bits) for each argument. Use 
commas to separate multiple arguments. 


An expression can be: 


e a fractional fixed point expression (range [-217, 21/>) 
e NULL (indicated by two adjacent commas: ,,) 


Multiple arguments are stored in successive address locations in sets of 
two bytes. If an argument is NULL its corresponding address location is 
filled with zeros. 


If the evaluated expression is out of the range [-217, 217>, the assembler 
issues a warning and saturates the fractional value. 


Example 
ACC: .ACCUM 0.1,0.2,0.3 


Related information 


d> .SPACE (Define storage) 
-FRACT / .SFRACT (Define 32-bit / 16-bit constant fraction) 
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.ALIGN 


Syntax 


.ALIGN expression 


Description 


b 


With the . ALIGN directive you instruct the assembler to align the location 
counter. By default the assembler aligns on one byte. 


When the assembler encounters the . ALIGN directive, it advances the 
location counter to an address that is aligned as specified by expression 
and places the next instruction or directive on that address. The alignment 
is in minimal addressable units (MAUs). The assembler fills the 'gap' with 
NOP instructions for code sections or with zeros for data sections. If the 
location counter is already aligned on the specified alignment, it remains 
unchanged. The location of absolute sections will not be changed. 


The expression must be a power of two: 2, 4, 8, 16, ... If you specify 
another value, the assembler changes the alignment to the next higher 
power of two and issues a warning. 


The assembler aligns sections automatically to the largest alignment value 
occurring in that secton. 


A label is not allowed before this directive. 


Example 


-ALIGN 16 the assembler aligns 
add d2,d2,d4 ; this instruction at 16 bytes and 
; fills the 'gap' with NOP instructions 


MU 


.ALIGN 12 
add d2,d2,d4 


WRONG: not a power of two, the 
assembler aligns this instruction at 
; 16 bytes and issues a warning 


se Ne 


Related information 


db 
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.ASCII/.ASCIIZ 


Syntax 
label:) .ASCIL  string|,string]... 


(label:| .ASCIIZ | siring|,siring)... 
Description 


With the .ASCII or . ASCIIZ directive the assembler allocates and 
initializes memory for each string argument. 


The .ASCII directive does not add a NULL byte to the end of the string. 
The .ASCIIZ directive does add a NULL byte to the end of the string. The 
”Z” in . ASCIIZ stands for "zero”. Use commas to separate multiple strings. 


Example 
STRING: .ASCII "Hello world” 


STRINGZ: .ASCIIZ "Hello world” 


& With the . BYTE directive you can obain exactly the same effect: 


STRING: -BYTE “Hello world” ; without a NULL byte 
STRINGZ: .BYTE "Hello world”,0 ; with a NULL byte 


Related information 
d> .SPACE (Define storage) 


.BYTE (Define a constant byte) 
.WORD / HALF (Define a word / halfword) 
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-BYTE 


Syntax 


abel] BYTE argumeni|,argumeni)... 


Description 


® 


With the . BYTE directive (Define Constant Byte) the assembler allocates 
and initializes a byte of memory for each argument. 


The .BYTE directive is not available for the PCP assembler. 


An argument can be: 


* a single or multiple character string constant 
e an integer expression 
e NULL (indicated by two adjacent commas: ,,) 


Multiple arguments are stored in successive byte locations. If an argument 
is NULL its corresponding byte location is filled with zeros. 


If you specify /abel, it gets the value of the location counter at the start of 
the directive processing. 


Integer arguments are stored as is, but must be byte values (within the 
range 0-255); floating-point numbers are not allowed. If the evaluated 
expression is out of the range [-256, +255] the assembler issues an error. 
For negative values within that range, the assembler adds 256 to the 
specified value (for example, -254 is stored as 2). 


In case of single and multiple character strings, each character is stored in 
consecutive bytes whose lower seven bits represent the ASCII value of the 
character. The standard C escape seguences are allowed: 


.BYTE 'R' 
.BYTE 'AB',,'D' 


0x52 
0x41420043 


se Ne 


Example 


TABLE .BYTE ‘two’,0,’strings’,0 
CHARS .BYTE 'A','B','C','D' 
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Related information 


d> -SPACE (Define storage) 


.ASCII / .ASCIIZ (Define ASCII string without/with ending NULL) 
.WORD / HALF (Define a word / halfword) 
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.CALLS 


Syntax 
.CALLS 'caller', ’callee’ |,call_frequency |,stack_usage]...| 


Description 


Create a flow graph reference between caller and callee. With this 
information the linker can build a call graph and calculate stack size. 
Caller and Callee are names of functions. The call freguency shows how 
many times the callee is called. The stack_usage represents the stack usage 
in bytes at the location of the call or the maximum stack usage of function 
caller. A function can use multiple stacks. 


The compiler inserts .CALLS directives automatically to pass call tree 
information. Normally it is not necessary to use the .CALLS directive in 
hand coded assembly. 


A label is not allowed before this directive. 


Example 
-CALLS ‘main’, 'nfunc', 1, 8 


Indicates that the function main calls the function nfunc 1 time and that 
the stack usage at the location of the call is 8 bytes. 


-CALLS ‘main’, '', 0, 8 


Specifies the maximum stack usage of function main (8 bytes). 


Related information 


J- 
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“ 
.COMMENT 


Syntax 
COMMENT delimiter 


delimiter 


Description 


With the . COMMENT directive (Start Comment Lines) you can define one or 
more lines as comments. The first non-blank character after the . COMMENT 
directive is the comment delimiter. The two delimiters are used to define 
the comment text. The line containing the second comment delimiter will 
be considered the last line of the comment. The comment text can include 
any printable characters and the comment text will be produced in the 
source listing as it appears in the source file. 


A label is not allowed before this directive. 


Example 


-COMMENT + This is a one line comment + 

-COMMENT * This is a multiple line 
comment. Any number of lines 
can be placed between the two 
delimiters. 


Related information 


d - 
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DEFINE 


Syntax 
-DEFINE symbol string 


Description 


With the . DEFINE directive you define a substitution string that you can 
use on all following source lines. The assembler searches all succeeding 
lines for an occurrence of symbol, and replaces it with string. If the symbol 
occurs in a double quoted string it is also replaced. Strings between single 
quotes are not expanded. 


This directive is useful for providing better documentation in the source 
program. A symbol can consist of letters, digits and underscore characters 
(_), and the first character cannot be a digit. 


The assembler issues a warning if you redefine an existing symbol. 


Macros represent a special case. . DEFINE directive translations are applied 
to the macro definition as it is encountered. When the macro is expanded 
any active . DEFINE directive translations will again be applied. 


A label is not allowed before this directive. 


Example 


If the following .DEFINE directive occurred in the first part of the source 
program: 


-DEFINE LEN '32' 
then the source line below: 


- SPACE LEN 
MSG "The length is: LEN” 


would be transformed by the assembler to the following: 


- SPACE 32 
MSG "The length is: 32” 


Related information 


-UNDEF (Undefine .DEFINE symbol) 
.SET (Set temporary value to a symbol) 
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“ 
-DUP / .ENDM 


Syntax 
llabel] -DUP expression 


-ENDM 


Description 


The sequence of source lines between the .DUP and .ENDM directives will 
be duplicated by the number specified by the integer expression. If the 
expression evaluates to a number less than or equal to 0, the sequence of 
lines will not be included in the assembler output. The expression result 
must be an absolute integer and cannot contain any forward references to 
address labels (labels that have not already been defined). You can nest 
the .DUP directive to any level. 


If you specify /abel, it gets the value of the location counter at the start of 
the DUP directive processing. 


Example 


Consider the following source input statements, 


COUNT .SET 3 
.DUP COUNT ; duplicate NOP count times 
NOP 
. ENDM 


This is expanded as follows: 


COUNT .SET 3 
NOP 
NOP 
NOP 


Related information 


.DUPA (Duplicate Seguence with Arguments), 
.DUPC (Duplicate Seguence with Characters), 
.DUPF (Duplicate Seguence in Loop), 
.MACRO (Define Macro) 
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-DUPA / .ENDM 


Syntax 
llabel] -DUPA formal arg,argument| argument]... 


-ENDM 


Description 


With the .DUPA and . ENDM directives (Duplicate Sequence with 
Arguments) you can repeat a block of source statements for each 
argument. For each repetition, every occurrence of the formal_arg 
parameter within the block is replaced with each succeeding argument 
string. If an argument includes an embedded blank or other 
assembler-significant character, it must be enclosed with single quotes. 


If you specify /abel, it gets the value of the location counter at the start of 
the .DUPA directive processing. 


Example 
Consider the following source input statements, 


.DUPA VALUE,12,,32,34 
.BYTE VALUE 
. ENDM 


This is expanded as follows: 


.BYTE 12 
-BYTE VALUE ; results in a warning 
-BYTE 32 
.BYTE 34 


The second statement results in a warning of the assembler that the local 
symbol VALUE is not defined in this module and is made external. 


Related information 


-DUP (Duplicate Sequence of Source Lines), 
-DUPC (Duplicate Sequence with Characters), 
-DUPF (Duplicate Sequence in Loop), 
-MACRO (Define Macro) 
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“ 
-DUPC / .ENDM 


Syntax 
llabel] -DUPC formal arg, string 


-ENDM 


Description 


With the .DUPC and .ENDM directives (Duplicate Sequence with 
Characters) you can repeat a block of source statements for each character 
within string. For each character in the string, the formal arg parameter 
within the block is replaced with that character If the string is empty, then 
the block is skipped. 


If you specify label, it gets the value of the location counter at the start of 
the .DUPC directive processing. 


Example 
Consider the following source input statements, 


-DUPC VALUE,'123' 
.BYTE VALUE 
. ENDM 


This is expanded as follows: 


.BYTE 1 
.BYTE 2 
.BYTE 3 


Related information 


.DUP (Duplicate Seguence of Source Lines), 
.DUPA (Duplicate Seguence with Arguments), 
.DUPF (Duplicate Seguence in Loop), 
.MACRO (Define Macro) 
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-DUPF / .ENDM 


Syntax 
[abel] 


Description 


.DUPF formal_arg,|start|,end|,increment| 


.ENDM 


With the .DUPF and .ENDM directives (Duplicate Sequence in Loop) you 
can repeat a block of source statements (end — start) + 1 / increment 
times. Start is the starting value for the loop index; end represents the final 
value. Increment is the increment for the loop index; it defaults to 1 if 
omitted (as does the start value). The formal_arg parameter holds the 
loop index value and may be used within the body of instructions. 


If you specify /abel, it gets the value of the location counter at the start of 
the . DUPF directive processing. 


Example 


Consider the following source input statements, 


.DUPF 


MOV 


. ENDM 


NUM,0,7 
D\NUM, #0 


This is expanded as follows: 


MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 


DO, #0 
D1,#0 
D2,#0 
D3,#0 
D4,#0 
D5,#0 
Dé, #0 
D7,#0 


Related information 


-DUP (Duplicate Sequence of Source Lines), 
-DUPA (Duplicate Sequence with Arguments), 
-DUPC (Duplicate Sequence with Characters), 
-MACRO (Define Macro) 
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“ 
END 


Syntax 
-END [expression] 


Description 


With the optional .END directive you tell the assembler that the logical end 
of the source program is reached. If the assembler finds assembly source 
lines beyond the .END directive, it ignores those lines and issues a 
warning. 


The expression is only permitted here for compatibility reasons. It is 
ignored during assembly. 


You cannot use the .END directive in a macro expansion. 


A label is not allowed before this directive. 


Example 


. END ;End of source program 


Related information 


f- 
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-EQU 


Syntax 
symbol .EQU expression 


Description 


With the . EQU directive you assign the value of expression to symbol 
permanently. Once defined, you cannot redefine the symbol. 


The expression can be relocatable or absolute and forward references are 
allowed. 


Example 
To assign the value 0x4000 permanently to the symbol A_D_PORT: 


A D PORT .EQU 0x4000 


You cannot redefine the symbol A_D_PORT after this. 


Related information 
d .SET (Set temporary value to a symbol) 
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.EXITM 


Syntax 
.EXITM 


Description 


With the . EXITM directive (Exit Macro) the assembler will immediately 
terminate a macro expansion. It is useful when you use it with the 
conditional assembly directive . IF to terminate macro expansion when, 
for example, error conditions are detected. 


A label is not allowed before this directive. 


Example 
CALC .MACRO XVAL,YVAL 
-IF XVAL<0 
.FAIL 'Macro parameter value out of range' 
.EXITM ;Exit macro 
.ENDIF 
- ENDM 


Related information 


.DUP (Duplicate Seguence of Source Lines), 
.DUPA (Duplicate Seguence with Arguments), 
.DUPC (Duplicate Seguence with Characters), 
.DUPF (Duplicate Seguence in Loop), 
.MACRO (Define Macro) 
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-EXTERN 


Syntax 
-EXTERN — symbol|, symbol]... 


Description 


With the . EXTERN directive (External Symbol Declaration) you specify that 
the list of symbols is referenced in the current module, but is not defined 
within the current module. These symbols must either have been defined 
outside of any module or declared as globally accessible within another 
module with the . GLOBAL directive. 


If you do not use the . EXTERN directive to specify that a symbol is 
defined externally and the symbol is not defined within the current 
module, the assembler issues a warning and inserts the . EXTERN directive 
for that symbol. 


A label is not allowed before this directive. 


Example 
.EXTERN AA,CC,DD ;defined elsewhere 
Related information 


-GLOBAL (Global symbol declaration) 
-LOCAL (Local symbol declaration) 


3-38 TriCore Reference Manual 


“ 
-FAIL 


Syntax 
.FAIL [string | exp}[,{string | exp)]...] 


Description 


With the . FAIL directive (Programmer Generated Error) you tell the 
assembler to output an error message during the assembling process. 


The total error count will be incremented as with any other error. The 
. FAIL directive is for example useful in combination with conditional 
assembly for exceptional condition checking. The assembly process 
proceeds normally after the error has been printed. 


Optionally, you can specify an arbitrary number of strings and expressions, 
in any order but separated by commas, to describe the nature of the 
generated error. If you use expressions, the assembler outputs the result. 
The assembler outputs a space between each argument. 


With this directive the assembler exits with exit code 1 (an error). 


A label is not allowed before this directive. 


Example 


-FAIL ‘Parameter out of range’ 
This results in the error: 
E143: ["filename” line] Parameter out of range 


Related information 


-MESSAGE (Programmer Generated Message), 
.WARNING (Programmer Generated Warning) 
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.FLOAT/.DOUBLE 


Syntax 
label) .FLOAT expression|,expression... 


label) .DOUBLE expression|,expression]... 


Description 


With the . FLOAT or .DOUBLE directive the assembler allocates and 
initializes a floating-point number (32 bits) or a double (64 bits) in 
memory for each argument. 


An expression can be: 


e a floating-point expression 
e NULL (indicated by two adjacent commas: ,,) 


You can represent a constant as a signed whole number with fraction or 
with the ’e’ format as used in the C language. 12.457 and +0.27E-13 are 
legal floating-point constants. 


If you specify label, it gets the value of the location counter at the start of 
the directive processing. 


If the evaluated argument is too large to be represented in a single word / 
double-word, the assembler issues an error and truncates the value. 


Examples 
FLT: .FLOAT 12.457,+0.27E-13 


DBL: -DOUBLE 12.457,+0.27E-13 


Related information 
d> .SPACE (Define storage) 
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“ 
FRACT/.SFRACT 


Syntax 


llabel:) .FRACT = expression|,expression]... 


llabel:) .SFRACT expression|,expression]... 


Description 


With the .FRACT or .SFRACT directive the assembler allocates and 
initializes one word of memory (32 bits) or a halfword (16 bits) for each 
argument. Use commas to separate multiple arguments. 


An expression can be: 


e a fractional fixed point expression (range [-1, +1>) 
e NULL (indicated by two adjacent commas: ,,) 


Multiple arguments are stored in successive address locations in sets of 
two bytes. If an argument is NULL its corresponding address location is 
filled with zeros. 


If the evaluated argument is out of the range [-1, +1> , the assembler 
issues a warning and saturates the fractional value. 


Example 
FRCT: -FRACT 0.1,0.2,0.3 


SFRCT: -SFRACT 0.1,0.2,0.3 


Related information 


d> -SPACE (Define storage) 
-ACCUM (Define 64-bit constant fraction in 18+46 bits format ) 
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.GLOBAL 


Syntax 
GLOBAL symwbol|,symbol])... 


Description 


All symbols or labels defined in the current section or module are local to 
the module by default. You can change this default behavior with 
assembler option ~ig. 


With the . GLOBAL directive (Global Section Symbol Declaration) you 
declare one of more symbols as global. This means that the specified 
symbols are defined within the current section or module, and that those 
definitions should be accessible by all modules, using the EXTERN 
directive. 


Only symbols that are defined with the . EOU directive or program labels 
can be made global. 


If the symbols that appear in the operand field are not used in the module, 
the assembler gives a warning. 


A label is not allowed before this directive. 


Example 


-SDECL “.data.io”,DATA 
.SECT ",data.io” 
-GLOBAL LOOPA ; LOOPA will be globally 
; accessible by other modules 
LOOPA .HALF 0x100 ; assigns the value 0x100 to LOOPA 


Related information 


d> .EXTERN (External symbol declaration) 
.LOCAL (Local symbol declaration) 
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- 


IF / -ELIF / .ELSE / .ENDIF 


Syntax 


«IF expression 


[.ELIF expression] (the . ELIF directive is optional) 
[.ELSE] (the .ELSE directive is optional) 
.ENDIF 

Description 


With the .IF/ .ENDIF directives you can create a part of conditional 
assembly code. The assembler assembles only the code that matches a 
specified condition. 


The expression must evaluate to an absolute integer and cannot contain 
forward references. If expression evaluates to zero, the . IF-condition is 


considered FALSE. Any non-zero result of expression is considered as 
TRUE. 


You can nest . IF directives to any level. The .ELSE, .ELIF and .ENDIF 
directives always refer to the nearest previous . IF directive. 


A label is not allowed before this directive. 


Example 


Suppose you have an assemble source file with specific code for a test 
version, for a demo version and for the final version. Within the assembly 
source you define this code conditionally as follows: 


IF TEST 

... 3 code for the test version 
.ELIF DEMO 

... ; code for the demo version 
.ELSE 

... ; code for the final version 


.ENDIF 
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Before assembling the file you can set the values of the symbols . TEST 
and .DEMO in the assembly source before the . IF directive is reached. For 
example, to assemble the demo version: 


TEST .SET 0 
DEMO .SET 1 


You can also define the symbols on the command line with the option -D: 


astc -DDEMO -DTEST=0 test.src 


Related information 


f- 
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“ 
INCLUDE 


Syntax 
INCLUDE filename | <filename> 


Description 


With the . INCLUDE directive you include another file at the exact location 
in the source where the . INCLUDE occurs. The . INCLUDE directive works 
similarly to the include statement in C. The source from the include file 
is assembled as if it followed the point of the . INCLUDE directive. When 
the end of the included file is reached, assembly of the original file 
continues. 


The filename specifies the filename of the file to be included. The 
filename must be compatible with the operating system 
(forward/backward slashes) and can include a directory specification. 


If an absolute pathname is specified, the assembler searches for that file. If 
a relative path is specified or just a filename, the order in which the 
assembler searches for include files is: 


1. The current directory if you used the ’filename’ construction. 
The current directory is not searched if you use the <fi/ename> syntax. 
2. The path that is specified with the assembler option -I. 


3. The path that is specified in the environment variable ASTCINC when 
the product was installed. 


4. The include directory relative to the installation directory. 
A label is not allowed before this directive. 


Example 


include file 
Do not look in 
current directory 


- INCLUDE ‘storage\mem.asm’ 
- INCLUDE <data.asm> 


se Ne Ne 


Related information 


d> Assembler option -I (Add directory to include file search path) in section 
5.2, Assembler Options, of Chapter Tool Options. 
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LOCAL 


Syntax 
LOCAL symbol|, symbol)... 


Description 


All symbols or labels defined in the current section or module are local to 
the module by default. You can change this default behavior with 
assembler option -ig. 


With the . LOCAL directive (Local Section Symbol Declaration) you declare 
one of more symbols as local. This means that the specified symbols are 
explicitly local to the module in which you define them. 


If the symbols that appear in the operand field are not used in the module, 
the assembler gives a warning. 


A label is not allowed before this directive. 


Example 


-SDECL “.data.io”,DATA 
.SECT ”.data.io” 
LOCAL LOOPA ; LOOPA is local to this section 


LOOPA .HALF 0x100 ; assigns the value 0x100 to LOOPA 


Related information 


d> .EXTERN (External symbol declaration) 
.GLOBAL (Global symbol declaration) 
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— 
MACRO / .ENDM 


Syntax 


macro name _ .MACRO ([(dumarg|,dumarg]...] 


macro_definition_statements 


-ENDM 
Description 


With the .MACRO directive you define a macro. Macros provide a 
shorthand method for handling a repeated pattern of code or group of 
instructions. You can define the pattern as a macro, and then call the 
macro at the points in the program where the pattern would repeat. The 
. ENDM directive indicates the end of the macro. 


The definition of a macro consists of three parts: 


e Header, which assigns a name to the macro and defines the arguments. 


e Body, which contains the code or instructions to be inserted when the 
macro is called. 


e Terminator, which indicates the end of the macro definition (ENDM 
directive). 


The arguments are symbolic names that the macro preprocessor replaces 
with the literal arguments when the macro is expanded (called). Each 
formal argument must follow the same rules as symbol names: the name 
can consist of letters, digits and underscore characters (_). The first 
character cannot be a digit. Argument names cannot start with a percent 
sign (96). 


Macro definitions can be nested but the nested macro will not be defined 
until the primary macro is expanded. 


You can use the following operators in macro definition statements: 
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Operator | Name Description 
\ Macro argument | Concatenates a macro argument with 
concatenation adjacent alphanumeric characters. 
? Return decimal Substitutes the ?symbol seguence with a 
value of symbol character string that represents the decimal 
value of the symbol. 
96 Return hex Substitutes the %symbo/ sequence with a 
value of symbol character string that represents the 
hexadecimal value of the symbol. 
” Macro string Allows the use of macro arguments as literal 
delimiter strings. 
^ Macro local label | Causes local labels in its term to be evaluated 
override at normal scope rather than at macro scope. 
Example 


The macro definition: 


CONSTD .MACRO reg,value ;header 
mov.u reg,#1lo(value) ; body 
addih reg,reg,#hi(value) 
. ENDM ;terminator 


The macro call: 


.SDECL 


.SECT ”.text” 


”.text”,code 


CONSTD d4,0x12345678 


The macro expands as follows: 


mov.u 
addih 


Related information 


d4,#10(0x12345678) 
d4,d4,#hi(0x12345678) 


-DUP (Duplicate Sequence of Source Lines), 
-DUPA (Duplicate Sequence with Arguments), 
-DUPC (Duplicate Sequence with Characters), 
.DUPF (Duplicate Sequence in Loop) 


Section 4.10, Macro Operations, in Chapter Assembly Language of the 
User’s Manual. 
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MESSAGE 


Syntax 


MESSAGE [istring | exp)lstring | exp)]...] 


Description 


With the . MESSAGE directive (Programmer Generated Message) you tell 
the assembler to output an information message durring assembly. 


The error and warning counts will not be affected. The . MESSAGE 
directive is for example useful in combination with conditional assembly 
for informational purposes. The assembly proceeds normally after the 
message has been printed. 


Optionally, you can specify an arbitrary number of strings and expressions, 
in any order but separated by commas, to describe the nature of the 
message. If you use expressions, the assembler outputs the result. The 
assembler outputs a space between each argument. 


This directive has no effect on the exit code of the assembler. 


A label is not allowed before this directive. 


Example 


-DEFINE LONG “SHORT” 
.MESSAGE 'This is a LONG string' 
.MESSAGE "This is a LONG string” 


Within single guotes, the defined symbol LONG is not expanded. Within 
double guotes the symbol LONG is expanded. So, the actual message is 
printed as: 


This is a LONG string 
This is a SHORT string 


Related information 


.FAIL (Programmer Generated Error) 
.WARNING (Programmer Generated Warning) 
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.ORG 


Syntax 
ORG [abs-loc]|,sect_type]|,attribute)... 


Description 


With the . ORG directive you can specify an absolute location (abs_/oc) in 
memory of a section. This is the same as a .SDECL/.SECT without a 
section name. 


This directive uses the following arguments: 


abs-loc Initial value to assign to the run-time location counter. 
abs-loc must be an absolute expression. If abs_loc is not 
specified, then the value is zero. 


sect_type An optional section type: 
code code section 
data data section 

attribute An optional section attribute: 


Code attibutes: 
init section is copied from ROM to RAM at startup 
noread section can be executed from but not read 


Data attibutes: 
noclear section is not cleared during startup 


max data overlay with other parts with the same 
name, is implicit a type of ’noclear’ 
rom data section remains in ROM 


A label is not allowed before this directive. 


Example 
; define a section on location 100 decimal 
.org 100 


; define a relocatable nameless section 
.org 


; define a relocatable data section 
.org ,data 
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; define a data section on 0x8000 
.org 0x8000,data 


Related information 


d> -SDECL (Declare section name and attributes) 
.SECT (Activate a declared section) 
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PMACRO 


Syntax 
-PMACRO symboll, symbol]... 


Description 


With the . PMACRO directive (Purge Macro) you tell the assembler to 
undefine the specified macro, so that later uses of the symbol will not be 


expanded. 
A label is not allowed before this directive. 
Example 
SPMACRO MAC1,MAC2 


This statement causes the macros named MAC1 and MAC2 to be undefined. 


Related information 
d> .MACRO (Define Macro) 
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“ 
.SDECL 


Syntax 
-SDECL ”name”, type |, attribute |... [AT address] 


Description 


With the . SDECL directive you can define a section with a name, type and 
optional attributes. Before any code or data can be placed in a section, 
you must use the . SECT directive to activate the section. 


This directive uses the following arguments: 


type: A section type: 
code code section 
data data section 
attribute: An optional section attribute: 


Code attibutes: 
init section is copied from ROM to RAM at startup 
noread section can be executed from but not read 


Data attibutes: 
noclear section is not cleared during startup 


max data overlay with other parts with the same 
name, is implicit a type of ’noclear’ 
rom data section remains in ROM 


Sections with attribute noclear are not zeroed at startup. This is a default 
attribute for data sections. You can only use this attribute with a data 
type section. This attribute is only useful with BSS sections, which are 
cleared at startup by default. 


The attribute init defines that the code section contains initialization 
data, which is copied from ROM to RAM at program startup. 


Sections with the attribute rom contain data to be placed in ROM. This 
ROM area is not executable. 


When data sections with the same name occur in different object 
modules with the attribute max, the linker generates a section with a size 
that is the largest of the sizes in the individual object modules. The 
attribute max only applies to data sections. 
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The name of a section can have a special meaning for locating sections. 
The name of code sections should always start with ”. text” (or 

” .pcptext” for PCP code). With data sections, the prefix in the name is 
important. The prefix determines if the section is initialized, constant or 
uninitialized and which addressing mode is used. 


Name prefix Type of DATA section 

.data initialized 

.Zdata initialized, abs 18 addressing 
.sdata initialized, aO addressing 
.data_a8 initialized, a8 addressing 
.data_a9 initialized, a9 addressing 

.rodata constant data 

.Zrodata constant data, abs 18 addressing 
.srodata constant data, a0 addressing 
.rodata_a8 constant data, a8 addressing 
.rodata_a9 constant data, a9 addressing 
.bss uninitialized 

.Zbss uninitialized, abs 18 addressing 
.Sbss uninitialized, aO addressing 
.bss_a8 uninitialized, a8 addressing 
.bss_a9 uninitialized, a9 addressing 
.ldata a1 addressing (read only constants, literal data) 
.pcpdata pcp data 


Table 3-1: Data section name prefixes 
Note that the compiler uses the following name convention: 


prefix.module-name.function-or-object-name 


Examples: 
-sdecl ”.text.t.main”, CODE ; declare code section 
.sect ”.text.t.main” ; activate section 


declare data section 
activate section 


-sdecl “.data.t.varl”, DATA 
.sect “.data.t.varl” 


PLU 
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.sdecl 


.sect 
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”.text.intvec.00a”, CODE ; declare interrupt 
; vector table entry for interrupt 10 
”.text.intvec.00a” ; activate section 


.SECT (Activate a declared section) 
-ORG (Initialize a nameless section) 
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.SECT 


Syntax 
SECT ”name” |, RESET] 


Description: 


With the .SECT directive you activate a previously declared section with 
the name name. Before you can activate a section, you must define the 
section with the .SDECL directive. You can activate a section as many 
times as you need. 


With the section attribute RESET you can reset counting storage allocation 
in data sections that have section attribute max. 


Examples: 
-sdecl ".zdata.t.var2”, DATA ; declare data section 
.sect ",zdata.t.var2” ; activate section 


d> -SDECL (Declare a section with name, type and attributes) 
-ORG (Initialize a nameless section) 
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“ 
.SET 


Syntax 


symbol .SET expression 


SET symbol expression 


Description 


With the . SET directive you assign the value of expression to symbol 
temporarily. If a symbol was defined with the . SET directive, you can 
redefine that symbol in another part of the assembly source, using another 
. SET. directive. 


The .SET directive is useful in establishing temporary or reusable counters 
within macros. Expression must be absolute and forward references are 
allowed. 


& Symbols that are set with the . EOU directive, cannot be redefined. 


Example 


COUNT .SET 0 Initialize COUNT. Later on you can 


assign other values to the symbol COUNT. 


Related information 


d> ..EOU (Assign permanent value to a symbol) 
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.SIZE 


Syntax 


.SIZE symbol, expression 


Description 


With the . SIZE directive you set the size of the specified symbol to the 
value represented by expression. 


The .SIZE directive may occur anywhere in the source file unless the 
specified symbol is a function. In this case, the . SIZE directive must occur 
after the function has been defined. 


Example 


main: .type func 
; function main 


retl6 
main function end: 
.size main,main function end-main 


Related information 
d> .TYPE (Set Symbol Type) 
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“ 
.SPACE 


Syntax 
label) SPACE expression 


Description 


With the . SPACE directive (Define Storage) the assembler reserves a block 
of memory. The reserved block of memory is not initialized to any value. 


With expression you specify the number of MAUs (Minimum Addressable 
Units) you want to reserve, and how much the location counter will 
advance. The expression must be an integer greater than zero and cannot 
contain any forward references to address labels (labels that have not yet 
been defined). For the TriCore assembler astc, the MAU size is 1 byte. For 
the PCP assembler aspcp, the MAU size is 2 bytes for pcp code sections 
and 4 bytes for pcp data sections. 


If you specify /abel, it gets the value of the location counter at the start of 
the directive processing. 


Example 


To reserve 12 bytes (not initialized) of memory in a TriCore data section: 


-sdecl ".zbss.tst.uninit”,DATA 
.sect ",zbss.tst.uninit” 
uninit .SPACE 12 ; Sample buffer 


Related information 


.ASCII / .ASCIIZ (Define ASCII string without/with ending NULL) 
-BYTE (Define a constant byte) 

-FLOAT / .DOUBLE (Define a 32-bit / 64-bit floating-point constant) 
.WORD / HALF (Define a word / halfword) 
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.T YPE 


Syntax 
symbol .TYPE typeid 


Description 


With the . TYPE directive you set a symbol’s type to the specified value in 
the ELF symbol table. Valid symbol types are: 


FUNC The symbol is associated with a function or other 
executable code. 


OBJECT The symbol is associated with an object such as a 
variable, an array, or a structure. 


FILE The symbol name represents the filename of the 
compilation unit. 


Labels in code sections have the default type FUNC. Labels in data sections 
have the default type OBJECT. 


Example 
Afunc -TYPE FUNC 


Related information 
d> .SIZE (Set Symbol Size) 
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-UNDEF 


Syntax 
.UNDEF symbol 


Description 


With the . UNDEF directive you can undefine a substitution string that was 
previously defined with the . DEFINE directive. The substitution string 
associated with symbol is released, and symbol will no longer represent a 
valid .DEFINE substitution. 


A label is not allowed before this directive. 


Example 


.UNDEF LEN ; Undefines the LEN substitution string 
that was previously defined with the 
; -DEFINE directive 


~. 


Related information 
d> -DEFINE (Define Substitution String) 
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.WARNING 


Syntax 
-WARNING («string | exp)lsiring | exp)]...] 


Description 
With the . WARNING directive (Programmer Generated Warning) you tell 
the assembler to output a warning message during the assembling process. 


The total warning count will be incremented as with any other warning. 
The .WARNING directive is for example useful in combination with 
conditional assembly for exceptional condition checking. The assembly 
process proceeds normally after the warning has been printed. 


Optionally, you can specify an arbitrary number of strings and expressions, 
in any order but separated by commas, to describe the nature of the 
generated warning. If you use expressions, the assembler outputs the 
result. The assembler outputs a space between each argument. 


This directive has no effect on the exit code of the assembler, unless you 
use the assembler option -—-warnings-as-errors. In that case the 
assembler exits with exit code 1 (an error). 


A label is not allowed before this directive. 


Example 
-WARNING ‘parameter too large’ 


This results in the warning: 


w144: ["filename" line] Parameter out of range 


Related information 


d> .FAIL (Programmer Generated Error), 
.MESSAGE (Programmer Generated Message) 
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“ 
WEAK 


Syntax 
.WEAK symbol|,symbol]... 


Description 


With the .WEAK directive you mark one of more symbols as 'weak'. The 
symbol can be defined in the same module with the .GLOBAL directive or 
the . EXTERN directive. If the symbol does not already exist, it will be 
created. 


A 'weak' external reference is resolved by the linker when a global (or 
weak) definition is found in one of the object files. However, a weak 
reference will not cause the extraction of a module from a library to 
resolve the reference. 


You can overrule a weak definition with a .GLOBAL definition in another 
module. The linker will not complain about the duplicate definition, and 
ignore the weak definition. 


Only program labels and symbols defined with EQU can be made weak. 


Example 


LOOPA .EQU 1 
-GLOBAL LOOPA 


; definition of symbol LOOPA 
; LOOPA will be globally 

; accessible by other modules 
«WEAK LOOPA ; mark LOOPA as weak 


Related information 


J- 
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WORD/.HALF 


Syntax 


label) WORD argumeni|,argumenl)... 


label) HALF argument| argument]... 


Description 


6 


With the .WORD or . HALF directive the assembler allocates and initializes 
one word (32 bits) or a halfword (16 bits) of memory for each argument. 


The .HALF directive is not available for the PCP assembler. 


An argument can be: 


* a single or multiple character string constant 
e an expression 
e NULL (indicated by two adjacent commas: ,,) 


Multiple arguments are stored in sets of four or two bytes. If an argument 
is NULL its corresponding address locations are filled with zeros. 


If you specify label, it gets the value of the location counter at the start of 
the directive processing. 


In case of single and multiple character strings, each character is stored in 
consecutive bytes whose lower seven bits represent the ASCII value of the 
character. The standard C escape seguences are allowed: 


.WORD 'R' ; = 0x52 

.WORD 'ABCD' ; = 0x41424344 

.HALF 'R' ; = 0x52 

.HALF 'AB' ; = 0x4142 

.HALF 'ABCD' ; = 0x4142 
0x4344 


If the evaluated argument is too large to be represented in a word / 
halfword, the assembler issues an error and truncates the value. 


Examples 


WRD: .WORD 14,1635,0x34266243,'ABCD' 


HLF: .HALF 14,1635,0x2662,'AB' 
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- 


& With the . BYTE directive you can obain exactly the same effect: 


WRD: .BYTE 14,0,0,0,1635%256,6,0,0, 
0x43,0x62,0x26,0x34,'D','C','B','A' 


HLF: .BYTE 14,0,16359$256,6,0x62,0x26,'B','A' 
Related information 


d> .SPACE (Define storage) 


.ASCII / .ASCIIZ (Define ASCII string without/with ending NULL) 
-BYTE (Define a constant byte) 
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3.3.3 OVERVIEW OF ASSEMBLER CONTROLS 


The following tables provide an overview of all assembler controls. 


Overview of assembler listing controls 


Function Description 

$LIST ON / OFF Generation of assembly list file temporary 
ON/OFF 

$LIST “flags” Exclude / include lines in assembly list file 

$PAGE Generate formfeed in assembly list file 

$PAGE settings Define page layout for assemly list file 

$PRCTL Send control string to printer 

$STITLE a program subtitle in header of assembly list 
ile 

$TITLE Set program title in headerof assembly list file 


Overview of miscellaneous assembler controls 


Function 


Description 


$CASE ON / OFF 
$defect_TCnum ON / OFF 


$DEBUG ON / OFF 
$DEBUG “flags” 
$FPU 

$HW_ONLY 


$IDENT LOCAL / GLOBAL 


$MMU 

$OBJECT 

$TC2 

$WARNING OFF [num] 


Case sensitive user names ON/OFF 


Enable/disable assembler check for specified 
functional problem, defect is one of CPU, DMU, 
PMI or PMU 


Generation of symbolic debug ON/OFF 
Select debug information 
Allow single precision floating-point instructions 


Prevent substitution of assembly instructions by 
smaller or faster instructions 


Assembler treats labels by default as local or 
global 


Allow memory management instructions 
Alternative name for the generated object file 
Allow TriCore 2 instructions 


Suppress all or some warnings 


3-65 


3-66 


P 


ASSEMBLY LANGUAGE 


TriCore Reference Manual 


3.3.4 DETAILED DESCRIPTION OF ASSEMBLER 


CONTROLS 


The assembler recognizes both upper and lower case for controls. 
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SCASE ON / OFF 


Syntax 


$CASE ON (default) 
$CASE OFF 


Description 


With the $CASE ON and $CASE OFF controls you specify whether the 
assembler operates in case sensitive mode or not. By default the assembler 
operates in case sensitive mode. This means that all user-defined symbols 
and labels are treated case sensitive, so LAB and Lab are distinct. Note that 
instruction mnemonics, register names, directives and controls are always 
treated case insensitive. 


Example 


;begin of source 
SCASE OFF ; assembler in case insensitive mode 


Related option 


d> Assembler option —c (Switch to case insensitive mode) in section 5.2, 
Assembler Options, of Chapter Tool Options. 


Related information 


f- 
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$defect_TCnum 


Syntax 
$CPU_TCnum ON 
$CPU_TCnum OFF 


$DMU TCnum ON 
$DMU TCmum OFF 


$PMI TCnum ON 
$PMI TCnum OFF 


$PMU_TCnum ON 
$PMU_TCnum OFF 


Description 


With these controls you can enable or disable specific CPU functional 
problem checks. 


When you use this control, the define _ defect_TCnum __ is set to 1. 


Example 


SCPU TCO018 ON ; enable assembler check for CPU 
; functional problem CPU TC.018, 
A CPU TC018 is defined 


Related option 


Assembler option —-silicon-bug (Check on CPU functional defect) in 
section 5.2, Assembler Options, of Chapter Tool Options. 


Related information 


See Chapter 9, CPU Functional Problems, for more information about the 
individual problems. 
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SDEBUG ON / OFF 


Syntax 
$DEBUG ON 
$DEBUG OFF 
$DEBUG ”flags” 
Description 


With the $BEBUG ON and $DEBUG OFF controls you turn the generation 
of debug infomation on or off. (SDEBUG ON is similar to the assembler 


option -gl). 
If you use $DEBUG control with flags, you can set the following flags: 


a/A assembler source line information 
h/H pass HLL debug information 


You cannot use these two types of debug information both. So, 
SDEBUG "ah” is not allowed. 


VL local symbols debug information 
s/S always debug; either "AhL” or "aHl” 


& Debug information that is generated by the C compiler, is always passed 
to the object file. 


Example 


;begin of source 
SDEBUG ON ; generate local symbols debug information 


Related option 


d> Assembler option -g (Select debug information) in section 5.2, Assembler 
Options, of Chapter Tool Options. 


Related information 


J- 
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$FPU 


Syntax 
$FPU 


Description 
With the $FPU control you instruct the assembler to accept and encode 
single precision floating-point instructions in the assembly source file. 


When you use this control, the define _ FPU__ is set to 1. By default the 
define _ FPU _ is set to 0 which tells the assembler not to accept single 
precision floating-point instructions. 


Example 


;begin of source 
SFPU ; the use of single precision FPU instructions 
; in this source is allowed. 


Related option 


d> Assembler option —-fpu-present (Allow the use of single precision 
floating-point instructions) in section 5.2, Assembler Options, of Chapter 
Tool Options. 


Related information 


J- 
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$HW_ONLY 


Syntax 
$HW_ONLY 


Description 


Normally the assembler replaces instructions by other, smaller or faster 
instructions. For example, the instruction jeq d0,#0, label1 is replaced 
by jz d0,labell. 


With the $HW_ONLY control you instruct the assembler to encode all 
instruction as they are. The assembler does not substitute instructions with 
other, faster or smaller instructions. 


Example 


;begin of source 

SHW_ONLY ; the assembler does not substitute 
instructions with other, smaller or 
faster instructions. 


Related option 


d> Assembler option -Og (Allow generic instructions) in section 5.2, 
Assembler Options, of Chapter Tool Options. 


Related information 


J- 
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SIDENT 


Syntax 
$IDENT LOCAL 
$IDENT GLOBAL 
Description 


With the controls $IDENT LOCAL and $IDENT GLOBAL you tell the 
assembler how to treat symbols that you have not specified explicitly as 
local or global with the assembler directives . LOCAL Or . GLOBAL. 


By default the assembler treats all symbols as local symbols unless you 
have defined them explicitly as global. 


Example 


;begin of source 
SIDENT GLOBAL ; assembly labels are global by default 


Related option 


d> Assembler option -i (Treat labels by default local / global) in section 5.2, 
Assembler Options, of Chapter Tool Options. 


Related information 


d> Assembler directive .LOCAL (Local symbol declaration) 
Assembler directive .GLOBAL (Global symbol declaration) 
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SLIST ON / OFF 


Syntax 
$LIST ON 


; assembly source lines 
$LIST OFF 


Description 


If you generate a list file with the assembler option -l, you can use the 
$LIST ON and $LIST OFF controls to specify which source lines the 
assembler must write to the list file. Without the command line option <l, 
the $LIST ON and $LIST OFF controls have no effect. 


The $LIST ON control actually increments a counter that is checked for a 
positive value and is symmetrical with respect to the $LIST OFF control. 
Note the following sequence: 


; Counter value currently 1 


SLIST ON ; Counter value - 2 
$LIST ON ; Counter value - 3 
SLIST OFF ; Counter value - 2 
SLIST OFF ; Counter value = 1 


The listing still would not be disabled until another $LIST OFF control 
was issued. 


Example 


Suppose you assemble the following assembly source with the assembler 
option -l: 


-.SDECL ”.text”,CODE 

.SECT ”.text” 

... ; source line in list file 
SLIST OFF 

... ; source line not in list file 
SLIST ON 

.... 7 source line also in list file 

. END 
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The assembler generates a list file with the following lines: 


.SDECL ”.text”,CODE 

-SECT ”.text” 

... ; source line in list file 

SLIST ON 
aw - 2 


. END 


source line also in list file 


Related option 


d> Assembler option -1 (Generate list file) in section 5.2, Assembler Options, 
of Chapter Tool Options. 


Related information 
d> Assembler control $LIST (Exclude / include lines in assembly list file) 


Assembler function @LST() in section 3.2, Built-in Asembly Functions. 
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SLIST flags 


Syntax 


Begin of assembly file 


$LIST 


Description 


If you generate a list file with the assembler option -l, you can use the 
$LIST controls to specify which type of source lines the assembler must 
exclude from the list file. Without the command line option -l, the $LIST 


*flags” 


control has no effect. 


You can set the following flags to remove or include lines: 


c/C 
d/D 
e/E 


g/G 
i/I 
UL 
m/M 
n/N 
p/P 
g/O 
r/R 
v/V 
w/W 
x/X 
y/Y 


If you do 


Lines with assembler controls 
Lines with section directives (SECT and .SDECL) 


Lines with symbol definition directives (EXTERN, .GLOBAL, 


LOCAL, .CALLS) 

Lines with generic instruction expansion 
Lines with generic instructions 

#Line source lines 

Lines with macro definitions (MACRO and .DUP) 
Empty source lines 

Lines with conditional assembly 

Lines with the .EQU or .SET directive 
Lines with relocation characters Çr’) 
Lines with .EQU or .SET values 
Wrapped part of a line 

Lines with expanded macros 

Lines with cycle counts 


not specify this control or the assembler option -Lf/ag, the 


assembler uses the default: -LCDEGiIMnPqrVWXy. 


Example 


To exclude assembly files with controls from the list file: 


;begin of source 
$LIST "c"” 
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Related option 


d> Assembler option -L (List file formatting options) in section 5.2, Assembler 
Options, of Chapter Tool Options. 


Related information 
d> Assembler control $LIST ON / OFF (Assembly list file ON / OFF) 


Assembler function @LST() in section 3.2, Built-in Asembly Functions. 
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$MMU 


Syntax 
$MMU 


Description 
With the $MMU control you instruct the assembler to accept and encode 


memory management instructions in the assembly source file. 


When you use this control, the define_ MMU _ is set to 1. 


Example 
;begin of source 
$MMU ; the use of memory management instructions 


; in this source is allowed. 


Related option 


d> Assembler option --mmu-present (Allow the use of memory 
management instructions) in section 5.2, Assembler Options, of Chapter 


Tool Options. 


Related information 


f- 
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SOBJECT 


Syntax 
$OBJECT file” 
$OBJECT OFF 
Description 


With the $SOBJECT control you can specify an alternative name for the 
generated object file. With the $OBJECT OFF control, the assembler does 
not generate an object file at all. 


Example 


;Begin of source 
$object "“xl.o” ; generate object file xl.o 


Related option 


d> Assembler option —o (Define output filename) in section 5.2, Assembler 
Options, of Chapter Tool Options. 


Related information 


J- 
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SPAGE 


Syntax 
$PAGE [width length ,blanktop,blankbim,blanklefi] 


Description 
If you generate a list file with the assembler option -l, you can use the 
$PAGE control to format the generated list file. 
width Number of characters on a line (1-255). Default is 132. 


length Number of lines per page (10-255). Default is 66. As a special 
case a page length of 0 (zero) turns off all headers, titles, 
subtitles, and page breaks. 


blanktop Number of blank lines at the top of the page. Default = 0. 
Specify a value so that blankiop + blankbim < length — 10. 


blankbitm _ Number of blank lines at the bottom of the page. Default = 0. 
Specify a value so that blankiop + blankbim < length — 10. 


blankleft Number of blank columns at the left of the page. Default = 0. 
Specify a value smaller than width. 


If you use the $PAGE control without arguments, it causes a 'formfeed': the 
next source line is printed on the next page in the list file. The $PAGE 
control itself is not printed. 


You can omit an argument by using two adjacent commas. If the 
remaining arguments after an argument are all empty, you can omit them. 


Example 


SPAGE ; formfeed, the next source line is printed 
; on the next page in the list file. 


SPAGE 96 ; set page width to 96. Note that you can 
; omit the last four arguments. 


$PAGE ,,3,3; use 3 line top/bottom margins. 


Related option 


J- 
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Related information 


db 


Assembler control $STITLE (Set program subtitle in header of list file) 
Assembler control $TITLE (Set program title in header of list file) 


Assembler option -1 (Generate list file) in Section 5.2, Assembler Options, 
of Chapter Tool Options. 


Assembler option -L (List file formatting options) in Section 5.2, Assembler 
Options, of Chapter Tool Options. 


TriCore Assembly Language 3-81 


SPRCTL 


Syntax 
$PRCTL exp|string|,exp | string]... 


Description 
If you generate a list file with the assembler option -l, you can use the 
$PRCTL control to send control strings to the printer. 


The $PRCTL control simply concatenates its arguments and sends them to 
the listing file (the control line itself is not printed unless there is an error). 


You can specify the following arguments: 


exp a byte expression which may be used to encode 
non-printing control characters, such as ESC. 


string an assembler string. which may be of arbitrary length, up to 
the maximum assembler-defined limits. 


The $PRCTL control can appear anywhere in the source file; the assembler 
sends out the control string at the corresponding place in the listing file. 


If a SPRCTL control is the last line in the last input file to be processed, 
the assembler insures that all error summaries, symbol tables, and 
cross-references have been printed before sending out the control string. 
In this manner, you can use a PRCTL control to restore a printer to a 
previous mode after printing is done. 


Similarly, if the $PRCTL control appears as the first line in the first input 
file, the assembler sends out the control string before page headings or 
titles. 
Example 
SPRCTL $1B,’E’ ; Reset HP LaserJet printer 


Related option 
Related information 


d> Assembler option -1 (Generate list file) in Section 5.2, Assembler Options, 
of Chapter Tool Options. 
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SSTITLE 


Syntax 
$STITLE ”title” 


Description 


If you generate a list file with the assembler option -l, you can use the 
$STITLE control to specify the program subtitle which is printed at the 
top of all succeeding pages in the assembler list file below the title. 


The specified subtitle is valid until the assembler encouters a new STITLE 
control. By default, the subtitle is empty. 


The $STITLE control itself will not be printed in the source listing. 


If the page width is too small for the title to fit in the header, it will be 
truncated. 


Example 


STITLE ‘This is the title’ 
SSTITLE ‘This is the subtitle’ 


The header of the second page in the list file will now be: 
TASKING TriCore Assembler vx.yrz Build nnn SN 00000000 


This is the title Page 2 
This is the subtitle 


Related option 
Related information 
d> Assembler control $TITLE (Set program title in header of list file) 


Assembler option -l (Generate list file) in Section 5.2, Assembler Options, 
of Chapter Tool Options. 
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$TC2 


Syntax 
$TC2 


Description 
With the $TC2 control you instruct the assembler to accept and encode 
TriCore 2 instructions in the assembly source file. 


When you use this control, the define __TC2__ is set to 1. 


Example 


;begin of source 
$TC2 ; the use of TriCore 2 instructions 


, 
; in this source is allowed. 


Related option 


d> Assembler option —-is-tricore2 (Allow the use of TriCore 2 instructions) 
in section 5.2, Assembler Options, of Chapter Tool Options. 


Related information 


J- 
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STITLE 


Syntax 
$TITLE “title” 


Description 


If you generate a list file with the assembler option -l, you can use the 
$TITLE control to specify the program title which is printed at the top of 
each page in the assembler list file. 


By default, the title is empty. 


If the page width is too small for the title to fit in the header, it will be 
truncated. 


Example 
STITLE ‘This is the title’ 
The header of the list file will now be: 


TASKING TriCore Assembler vx.yrz Build nnn SN 00000000 
This is the title Page 1 


Related option 
Related information 
d> STITLE (Set program subtitle in header of assembly list file) 
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SWARNING OFF 


Syntax 


$ WARNING OFF 
$WARNING OFF number 


Description 


With the $WARNING OFF control you can suppresses all warning 
messages or specific warning messages. 


e By default, all warnings are reported. 
e If you specify this option but without numbers, all warnings are 


suppressed. 
e If you specify this option with a number, only the specified warning is 
suppressed. 
Example 
SWARNING OFF ; all warning messages are suppressed 


SWARNING OFF 135 ; suppress warning message 135 


Related option 


d> Assembler option —w (Suppress some or all warnings) in section 5.2, 
Assembler Options, of Chapter Tool Options. 


Related information 


J- 
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RUN-TIME 
ENVIRONMENT 


ail TASKING M 


diLdVHO 


Run-time Environment 


4.1 INTRODUCTION 


This chapter describes the startup code used by the TASKING TriCore C 
compiler, the stack layout and the heap; and the floating-point arithmetic. 


4.2 STARTUP CODE 


db 


You need the run-time startup code to build an executable application. 
The default startup code consists of the following components: 


e Initialization code. This code is executed when the program is 
initiated and before the function main ( ) is called. 


e Exit code. This controls the closedown of the application after the 
program's main function terminates. 


e Tbe trap vector table. This contains default trap vectors. 


The startup code is part of the C library libc.a, and the source is present 
in the file cstart.asm in the directory lib\src. 


If the default run-time startup code does not match your configuration, 
you need to modify the startup code accordingly. 


See also section 7.6, Linking the C Startup Code in Chapter Using the Linker 
of the User’s Manual. 


The entry point of the startup code (power-on vector) is label _START. 
This global label should not be removed, since the C compiler refers to it. 
It is also used as the default start address of the application. 


Initialization code 


The following initialization actions are executed before the application 
starts: 


1. Re-enable and reset the call depth counter and make AO, Al, A8, A9 
write—able. It is required for CrossView Pro that these RESET values are 
restored for each time the startup code is executed. 


2. Initialize the user stack pointer. The user stack pointer is loaded into 
memory by the stack address, located at _lc_ue_ustack. This label is 
defined in the Linker Script File. See section 4.3, Stack Usage for 
detailed information on the stack. 
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3. Clear Previous Context Pointer Segment Address and Offset Field. It is 
reguired for CrossView Pro's stack trace that these RESET values are 
restored for each time the startup code is executed. 


4. Setup the context save area lists. Tables with start/end addresses go in 
a separate 'csa areas' section. 


5. Initialize registers and bus configuration. In the file cstart. asm the 
actual location of several special function registers is reguired. These 
addresses are specified in the regcpu_name.def SFR system include 
files. You can include such a file with the assembler option 
-Ccpu_ name. In EDE the appropriate file is included when you have 
selected a CPU type. If you do not specify an SFR file, the default SFR 
regtcllib.def file is included. 


6. Load Base Address of Trap Vector Table. This address is indicated by 
the linker label _lc_u trap_tab as defined in the Linker Script File. 


7. Load Base Address of Interrupt Vector Table. This address is indicated 
by the linker label _lc_u_int_tab as defined in the Linker Script File. 


8. Initialize the interrupt stack pointer. The interupt stack pointer is 
loaded into memory by the interrupt stack address, located at 
_lc ue istack. This label is defined in the Linker Script File. 


9. Initialize and clear C variables. 


10. Copy initialized sections from ROM to RAM, using a linker generated 
table (also known as the ’copy table’) and a run-time library function 
_c init. 


11. Initialize the argc and argv arguments to zero. 


12. Call the entry point of your application with a call to function main(). 


Exit code 


When the C application 'returns', which is not likely to happen in an 
embedded environment, the program ends with a DEBUG16 instruction, at 
the assembly label _exit. When using a debugger, it can be useful to set 
a breakpoint on this label to indicate that the program has reached the 
end, or that the library function exit() has been called. 


Run-time Environment 


Trap vector table 


The default startup code makes sure that the trap vectors for exceptions 0 
to 7 are filled in. Default trap vectors are resolved from the C library. You 
can overrule these routines with your own exception routines. 


To disable a default trap vector from EDE: 
1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 


2. Expand the Processor entry, expand Startup, expand Startup Code 
and select Trap Vectors. 


3. Disable the trap vectors you do not want to be automatically defined in 
the startup code. 


d> See also section 3.9.2, Interrupt and Trap Functions in Chapter TriCore C 
Language of the User's Manual. 


Control Startup Code from EDE 


To control cstart.asm from within EDE, you first have to add 
cstart.asm to your project: 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Startup. 


3. Enable the option Automatically copy and link cstart.asm to your 
project. 


The file cstart.asm is copied to your project directory and added to 
your project. 


Now you can specify all your startup settings in the pages Startup Code, 
Boot Memory and Memory Control. 


You can specify CPU settings in the same dialog: 
1. From the Project menu, select Project Options... 
The Project Options dialog appears. 


2. Expand the Processor entry and select Bus Configuration. 
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3. Select the appropriate bus configuration settings. 
EDE automatically defines macros according to the selected settings. 


Macro Preprocessor Symbols 


A number of macro preprocessor symbols are used in the startup code. 
These can be enabled or disabled using the assembler command line 
option -D with the following syntax: 


-Dideniifier|=replacemeni)). 


In the startup file (cstart.asm) the following macro preprocessor 
symbols are used: 


[Define Description | 
| External Boot Memory Configuration (BOOTCFG) = si 
| BOOTCFG_VALUE | Boot memory Offset Address + 0x4 | 
| Memory Control (PMUCON/DMUCON) | 


_PMU_ EIFCON VALUE If defined, value of PMU External Instruction 
Fetch Control register 


| _DMU CON DCAON | If defined, Enable data cache | 


Startup 


_NO_BTV_INIT If defined, Base Address of Trap Vector Table is 
not initialized with trap table start address 
(trap_tab). 

_NO_BIV_INIT If defined, Base Address of Interrupt Vector 
Table is not initialized with interrupt table start 
address (_Ic_u_int_tab). 

_NO_ISP_INIT If defined, Interrupt Stack Pointer is not initialized 
with end address of interrupt stack 
(_Ilc_ue_istack). 


_NO_USP_INIT If defined, User Stack Pointer is not initialized 
with end address of user stack (_Ic_ue_istack). 

_NO_PCX RESET If defined, the Previous Context is not explicitly 
cleared. 

_NO_PSW_RESET If defined, the Call Depth Counter is not explicitly 
cleared. 


Run-time Environment 


Define Description 


_NO A0A1_ ADDRESSING | If defined, global address register AO/A1 is not 
initialized with start address of the _a0/ a1 
addressable area (_Ic_gb_a0/1). 


_NO_A8A9_ ADDRESSING | If defined, global address register A8/A9 is not 
initialized with start address of the _a8/_a9 
addressable area (_Ic_gb_a8/9). 


_NO_CSA_INIT If defined, Context Save Area lists are not 
initialized. 
| _NO WATCHDOG _INIT | If defined, Watchdog timer disabled. | 


_NO BUS CONF If defined, bus configuration registers are not 
initialized. 


| .NO_C INIT | If defined, C variables are not initialized. | 


| NO_ARG_INIT | If defined, disable initialization of argc and argv[]. | 


_NO_EXIT If defined, C library function exit() or abort() not 
supported. 


_USERDEFINED TRAP_n |If defined, the default trap vector n is disabled. 


| Miscellaneous S 


LL ———— INIT Can be set to a function to be called before 
main. This function cannot have a return or 
arguments. This function can be used, for 
example, to initialize the serial port before main 
is called. This is useful for building programs 
without making any modifications to the original 
source. 


_CALL ENDINIT Can be set to a function to be called before the 
ENDINIT instruction is executed. Like the 
CALLINIT function, it cannot not have a return 
value or arguments. 


CPU functional bypasses 


_TC112_XXX If defined, TC112 CPU functional defect XXX is 
bypassed and/or checked. 


_TC113_XXX If defined, TC113 CPU functional defect XXX is 
bypassed and/or checked. See Chapter 9 CPU 
Functional Problems for a complete list of these 
macros. 


Table 4-1: Defines used in cstart.src 
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The following table shows the linker labels used in the startup code. 


[Define Description sd 
_START start label, mentioned in LSL file (tc_arch.Isl) 

start label of exit() function 

_CALL INIT label called before main() 


Table 4-2: Linker labels used in startup code 


Run-time Environment 


4.3 STACK USAGE 


The stack is used for local automatic variables and function parameters. 


The following diagram show the structure of a stack frame. 


high memory 
incoming 
stack parameters 


rows down V wR Â 
i III] on eny 


local variables 


framesize 


outgoing 
parameters 


~« sp Y 
($sp) 


during execution 


low memory 


Figure 4-1: Stack diagram 


The stack size is defined in the linker script file (tc_arch.1s1 in 
directory include.1s1) with the macro USTACK and ISTACK, which 
results in sections called ustack and istack. 


The linker defined label _lc_ue_ustack refers to the top of the user 
stack area and is used in the file cstart. asm to initialize the user stack 
pointer register (SP). The linker defined label _lc_ue_istack refers to 
the top of the interrupt stack area and is used in the file cstart.asm to 
initialize the interrupt stack pointer register (ISP) 


As long as the user program does not change the IS bit in the program 
status word (PSW), only the user stack is used. Refer to the TriCore 
Architecture (v1.3) Manual for the implications of an IS bit change. 
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4.4 HEAP ALLOCATION 


6 


The heap is only needed when you use one or more of the dynamic 
memory management library functions: malloc(), calloc(), free() 
and realloc(). The heap is a reserved area in memory. Only if you use 
one of the memory allocation functions listed above, the linker 
automatically allocates a heap, as specified in the linker script file with the 
keyword heap. 


A special section called heap is used for the allocation of the heap area. 
The size of the heap is defined in the linker script file (tc_arch.1s1 in 
directory include.lsl) with the macro HEAP, which results in a section 
called heap. The linker defined labels _Ic_bh and _1c_eh (begin and 
end of heap) are used by the library function sbrk(), which is called by 
malloc() when memory is needed from the heap. 


The special heap section is only allocated when its linker labels are used 
in the program. 


4.5 FLOATING-POINT ARITHMETIC 


Floating-point arithmetic support for the compiler cte is included in the 
software as a separate set of libraries or in the hardware when available 
(only single precision). During linking you have to specify the desired 
floating-point library after the C library. The libraries are reentrant, and 
only use temporary program stack memory. 


To ensure portability of floating-point arithmetic, floating-point arithmetic 
for the compiler ctc has been implemented complying with the IEEE-754 
standard for floating-point arithmetic. See the IEEE Standard Binary for 
Floating-Point Arithmetic document [IEEE Computer Society, 1985] for 
more details on the floating-point arithmetic definitions. This document is 
referred to as IEEE-754 in this manual. 


The compiler ctc supports both single and double precision floating-point 
operations using the ISO C types float and double respectively. To 
optimize for speed, also a non-trapping library is included. 


It is possible to intercept floating-point exceptional cases and, if desired, 
handle them with an application defined exception handler. The 
intercepting of floating-point exceptions is referred to as ’trapping’. 
Examples of how to install a trap handler are included. 


Run-time Environment 


4.5.1 COMPLIANCE WITH IEEE-754 


The level to which the floating-point implementation complies with the 
IEEE-754 standard, depends on the choosen configuration. 


All floating-point calculations are executed using the 'round to nearest 
(even)’ rounding mode, since this is required by ANSI-C 89. This is 
conform IEEE-754. Because there are no double precision floating-point 
hardware instructions, an emulating library is always needed for double 
precision calculation. 


When the use of hardware FPU instructions is choosen (—-fpu-present), 
the available hardware instructions for single precision floating-point will 
be used either in the compiler or in one of the libraries. For double 
precision floating-point calculations the choosen floating-point emulaton 
library will be used. When no hardware FPU instructions are allowed, all 
floating-point operations will be used from the choosen floating-point 
emulaton library. 


In EDE you can specify to use the single precision floating-point: 
1. From the Project menu, select Project Options... 

The Project Options dialog appears. 
2. Expand the C Compiler entry and select Miscellaneous. 


3. Enable the option Single precision floating-point only: treat type 
*double’ as ’float’. 


d> Compiler option —-fpu-present in Chapter 5, Tool Options. 


Compliance with IEEE-754: TriCore hardware FPU instructions 


The following implementation issues for the single precision hardware 
instructions (optionally implemented on the TriCore chip), are important: 


e subnormals are not supported (hardware design decision). 


e when converting single precision floats to integers, rounding is done to 
the nearest (even) integer. This does not comply with ANSI-C 89 or 
ISO-C 99, but does comply with IEEE-754, since this is the current 
rounding mode (hardware design decision). 


* when a converted single precision float overflows the target integer 
type, the value is saturated to MAX INT or MIN INT (hardware design 
decision). 
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whenever a double precision float is involved, the results are 
determined by the chosen emulation library. 


Compliance with IEEE-754: Trapping emulation library 


The following implementation issues for the trapping floating—point library 
are important: 


subnormals are not supported. This is conform the TriCore hardware 
design. 

when converting floats to integers, the value is truncated. This complies 
with ANSI-C 89 and ISO-C 99, but does not comply with IEEE-754, 
since the current rounding mode is ’round to nearest (even)’. 

when a converted float overflows the target integer type, a predictable 
value is assigned to the target integer. 


Compliance with IEEE-754: Hand-optimized non-trapping emulation 
library 


The following implementation issues for the non-trapping floating-point 
library are important: 


when calculating with floats, rounding is done to the nearest integer 
(rounding towards infinity when equally near). 


there is no distinction between —0 and +0 

when an operand of a calculation is a NaN, Inf or subnormal, the result 
is undefined. 

when the result of a calculation would be a subnormal, the result is 0. 
whenever a NaN or Inf would be the result of a calculation, the result 
is undefined 

when converting single precision floats to integers, rounding is done to 
the nearest integer (rounding towards infinity when equally near). This 
is similar to the TriCore FPU hardware. 

when converting double precision floats to integers, the value is 
truncated. This is similar to the trapping emulation library. 

when a converted float overflows the target integer type, the value is 
saturated to MAX INT or MIN INT. 


Run-time Environment 


4.5.2 SPECIAL FLOATING-POINT VALUES 


Below is a list of special, IEEE-754 defined, floating-point values as they 


can occur during run-time. 


Special value Sign Exponent Mantissa 
“0.0 (Positive Zero) 0 all zeros all zeros 
-0.0 (Negative Zero) 1 all zeros all zeros 
+INF (Positive Infinite) 0 all ones all zeros 
-INF (Negative Infinite) 1 all ones all zeros 
NaN (Not a number) 0 all ones not all zeros 


Table 4-3: Special floating-point values 


4.5.3 TRAPPING FLOATING-POINT EXCEPTIONS 


Four floating-point libraries are delivered: 


Library to link | Description 

libfp.a Floating-point library (non-trapping, no FPU). 
This is the default. 

libfpt.a Floating-point library (trapping, no FPU) 
(Control program option —-fp-trap) 

libfp_fpu.a Floating-point library (non-trapping, with FPU instructions) 
(Compiler option --fpu-present) 

libfpt_fpu.a Floating-point library (trapping, with FPU instructions) 
(Control program option —-fp-trap, compiler option 
—-fpu-present) 


Table 4-4: Floating-point libraries 


Both EDE and the control program cctc automatically select the 
appropriate libraries depending on the specified TriCore derivative. By 


specifying the —-fp-trap option to the control program cctc, the trapping 


type floating-point library is linked into your application. By specifying 
the —-fpu-present option to the control program cctc, a floating-point 
library with single precision FPU instructions is linked into your 
application. If these options are not specified, the floating-point library 
without trapping mechanism and without FPU instructions is used. 
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In EDE you can specify to use the trapping type floating-point library as 
follows: 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Libraries. 


3. Enable the option Use traping floating-point library. 


IEEE-754 Trap Handler 


In the IEEE-754 standard a trap handler is defined, which is invoked on 
(specified) exceptional events, passing along much information about the 
event. To install your own trap handler, use the library call 

_fp install trap handler. When installing your own exception 
handler, you must select on which types of exceptions you want to have 
your handler invoked, using the function call 

_fp set exception mask. See below for more details on the 
floating-point library exception handling function interface. 


SIGFPE Signal Handler 


In ANSI-C the regular approach of dealing with floating-point exceptions 
is by installing a so-called signal handler by means of the ANSI-C library 
call signal. If such a handler is installed, floating-point exceptions cause 
this handler to be invoked. To have the signal handler for the SIGFPE 
signal actually become operational with the provided floating-point 
libraries, a (very) basic version of the IEEE-754 exception handler must be 
installed (see example below) which will raise the desired signal by means 
of the ANSI-C library function call raise. For this to be achieved, the 
function call fp install_ trap handler is present. When installing 
your own exception handler, you will have to select on which types of 
exceptions you want to receive a signal, using the function call 

_fp set exception mask. See further below for more details on the 
floating-point library exception handling function interface. 


There is no way to specify any information about the context or nature of 
the exception to the signal handler. Just that a floating-point exception 
occurred can be detected. See therefor the IEEE-754 trap handler 
discussion above if you want more control over floating-point results. 


Run-time Environment 


Example: 


finclude <float.h> 
finclude <signal.h> 


static void pass_fp exception to signal( 
_fp exception info_t *info ) 


{ 
info; /* suppress parameter not used warning */ 
/* cause SIGFPE signal to be raised */ 
raise( SIGFPE ); 
/* 
* now continue the program 
* with the unaltered result 
*/ 
} 


4.5.4 FLOATING-POINT TRAP HANDLING API 


For purposes of dealing with floating-point arithmetic exceptions, the 
following library calls are available: 


#include <float.h> 


int _fp_get_exception_mask( void ); 
void _fp set exception mask( int ); 


A pair of functions to get or set the mask which controls which type of 
floating-point arithmetic exceptions are either ignored or passed on to the 
trap handler. The types of possible exception flag bits are defined as: 


EFINVOP 
EFDIVZ 
EFOVFL 
EFUNFL 
EFINEXCT 


while, 
EFALL 


is the OR of all possible flags. See below for an explanation of each flag. 


4-16 TriCore Reference Manual 


- 


#include <float.h> 


int _fp get exception _status( void ); 
void _fp set exception status( int ); 


A pair of functions for examining or presetting the status word containing 
the accumulation of all floating-point exception types which occurred so 
far. See the possible exception type flags above. 


#include <float.h> 


void _fp install_trap handler( void (*) 
( fp exception info_t * ) ); 


This function call expects a pointer to a function, which in turn expects a 
pointer to a structure of type fp exception info_t. The members of 
_fp exception info_t arc: 


exception 
This member contains one of the following (numerical) values: 


EFINVOP 
EFDIVZ 
EFOVFL 
EFUNFL 
EFINEXCT 


operation 
This member contains one of the following numbers: 


_OP_ADDITION 
_OP_SUBTRACTION 
_OP_COMPARISON 
_OP_EQUALITY 
_OP_LESS_THAN 
_OP_LARGER_THAN 
_OP_MULTIPLICATION 
_OP_DIVISION 
_OP_CONVERSION 


source _ format 
destination_format 


Run-time Environment 


Numerical values of these two members are: 


_TYPE SIGNED CHARACTER 
_TYPE UNSIGNED CHARACTER 
_TYPE SIGNED SHORT INTEGER 
_TYPE UNSIGNED SHORT INTEGER 
_TYPE SIGNED INTEGER 

_TYPE UNSIGNED INTEGER 

_TYPE SIGNED LONG INTEGER 
_TYPE UNSIGNED LONG INTEGER 
_TYPE FLOAT 

_TYPE DOUBLE 


operand1 /* left side of binary or */ 

/* right side of unary */ 
operand2 /* right side for binary */ 
result 


These three are of the following type, to receive and return a value 
of arbitrary type: 


typedef union fp value_union t 


{ 


char c; 
unsigned char uc; 
short s; 
unsigned short us; 
int i; 
unsigned int ui; 
long 1; 
unsigned long ul; 
float f; 

#if ! SINGLE FP 
double d; 

#endif 

} 


fp value union t; 


& The member d is not present when specifying the -F option (treat double 
as float) to the C compiler. 
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The following table lists all the exception code flags, the corresponding 
error description and result: 


Error Description Exception Flag Default Result with Trapping 
Invalid Operation EFINVOP NaN 
Division by zero EFDIVZ “INF or -INF 
Overflow EFOVFL “INF or -INF 
Underflow EFUNFL zero 
Inexact EFINEXT undefined 
INF Infinite which is the largest absolute floating-point number, 
which is always: -INF < every finite number < +INF 
NAN Not a Number, a symbolic entity encoded in floating-point format. 


Table 4-5: Exception Type Flag Codes 


To ensure all exception types are specified, you can specify EFALL to a 
function, which is the binary OR of all above enlisted flags. 


TOOL OPTIONS 
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Tool Options - Compiler 


5.1 COMPILER OPTIONS 


This section lists all compiler options. 


Options in EDE versus options on the command line 


Most command line options have an equivalent option in EDE but some 
options are only available on the command line. If there is no equivalent 
option in EDE, you can specify a command line option in EDE as follows: 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the C Compiler entry and select Miscellaneous. 


3. Enter one or more command line options in the Additional options 
field. 


Be aware that some command line options are not useful in EDE or just 
do not have any effect. For example, the option —n sends output to stdout 
instead of a file and has no effect in EDE. 


Sbort and long option names 


Options have both short and long names. Short option names always 
begin with a single minus (—) character, long option names always begin 
with two minus (—-) characters. You can abbreviate long option names as 
long as it forms a unigue name. You can mix short and long option names 
on the command line. 


Options can have flags or suboptions. To switch a flag 'on', use a 
lowercase letter or a -Hongflag. To switch a flag off, use an uppercase 
letter or a -longflag. Separate longflags with commas. The following two 
invocations are eguivalent: 


ctc -Oac test.c 
ctc --optimize=+coalesce,+cse test.c 


When you do not specify an option, a default value may become active. 
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-? (--help) 


EDE 


Command line syntax 
-? 
—-help|[=iiem| 
You can specify the following arguments: 


intrinsics Show the list of intrinsic functions 

options Show extended option descriptions 

pragmas Show the list of supported pragmas 
Description 


Displays an overview of all command line options. When you specify an 
argument you can list extended information such as a list of intrinsic 
functions, pragmas or option descriptions. 


Example 


The following invocations all display a list of the available command line 
options: 


ctc =? 
ctc —-help 
ctc 
The following invocation displays a list of the available pragmas: 


ctc —-help-pragmas 


Related information 


d> - 


Tool Options - Compiler 


-A (—-language) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Language. 


3. Enable or disable the options Allow C++ style comments in ISO C90 
mode and Allow relaxed const check for string literals. 


Command line syntax 
~Alflags| 
—-language=(/lags| 


You can set the following flags: 


g/G (t/-gcc) Enable a number of gcc extensions 
p/P (+/-comments) Allow C++ style (//)comments in ISO C90 
x/X (+/-strings) Relaxed const check for string literals 
Default 
-AGpx 
Description 


With this option you control the language extensions the compiler can 
accept. By default the TriCore C compiler allows all language extensions, 
except for gcc extensions. 


The option -A (—-language) without flags is the equivalent of -AGPX 
and disables all language extensions. 


With —Ag you tell the compiler to enable the following gcc languages 
extensions: 

* The identifier _ FUNCTION ___ expands to the current function name. 
e Alternative syntax for variadic macros. 

e Alternative syntax for designated initializers. 

e Allow zero sized arrays. 

e Allow empty struct/union. 
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e Allow empty initializer list. 

e Allow initialization of static objects by compound literals. 

e The middle operand of a ? : operator may be omitted. 

e Allow a compound statement inside braces as expression. 

e Allow arithmetic on void pointers and function pointers. 

e Allow a range of values after a single case label. 

e Additional preprocessor directive #warning. 

e Allow comma operator, conditional operator and cast as lvalue. 
e An inline function without "static” or ”"extern” will be global. 
e An”extern inline” function will not be compiled on its own. 


For an exact description of these gcc extensions, please refer to the gcc 
info pages (info gcc). 


With -Ap you tell the compiler to allow C++ style comments (//) in ISO 
C90 mode (option —c90). In ISO C99 mode this style of comments is 
always accepted. 


With -Ax you tell the compiler not to check for assignments of a constant 
string to a non-constant string pointer. With this option the following 
example does not produces a warning: 


char *p; 
void main( void ) { p = “hello”; } 
Example 
ctc -APx -c90 test.c 
ctc —-language--comments,*strings --iso-90 test.c 


The compiler compiles in ISO C90 mode, accepts assignments of a 
constant string to a non-constant string pointer but ignores C++ style 
comments. 


Related information 


d> Compiler option —c (ISO C standard) 


Tool Options - Compiler 


—-align 


EDE 


1. From the Project menu, select Project Options... 

Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Code Generation. 
3. Specify a value in the Minimum alignment field. 


Command line syntax 


—-align=value 


Default 
—-align—1 


Description 


By default the TriCore compiler aligns objects to the minimum alignment 
reguired by the architecture. With this option you can increase this 
alignment for objects of four bytes or larger. The value must be a power of 
two. 


Example 
To align all objects of four bytes or larger on a 4—byte boundary, enter: 
ctc —-align-4 test.c 


Instead of this option you can also specify the following pragma in your C 
source: 


fpragma align 4 
With #pragma align restore you can return to the previous alignment 
setting. 
Related information 


d> Section 3.7, Controlling the Compiler: Pragmas, in Chapter TriCore C 
Language of the TriCore User’s Manual. 
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-C (—cpu) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Processor Definition. 


3. Select a processor from the Target processor list. 


Command line syntax 
-Ccpu 


—-cpu—cpu 


Description 


With this option you define the target processor for which you create your 
application. By default EDE generates an object file for the TC11IB. 


Based on the target processor the compiler automatically detects whether a 
FPU-unit is present and whether the architecture is a TriCore2. This means 
you do not have to specify the compiler options --fpu-present and 

—-is-tricore2 explicitly when one of the supported derivatives is selected. 


The compiler always includes the register file regcpu . sfr, unless you 
disable the option Automatic inclusion of ’.sfr’ file on the Preprocessing 
page of the Compiler options (command line option --no-tasking-sfr). 


Example 
To compile the file test.c for the TC11IB processor and use the SFR file 
regtcllib.sfr: 


ctc -Ctcllib test.c 
ctc -—-cpu=tcllib test.c 


To avoid conflicts, make sure you specify the same target processor to the 
assembler. 


Tool Options - Compiler 


Related information 
d> Compiler option —-no-tasking-sfr (Do not include SFR file) 


Assembler option -C (Select CPU) 
Control program option -C (Use SFR definitions for CPU) 


Section 5.4, Calling tbe Compiler, in Chapter Using the Compiler of the 
User’s Manual. 
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-c (—-iso) 
EDE 
1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Language. 
3. Select the ISO C standard C90 or C99. 
Command line syntax 
-c{90 | 99) 
—-iso—(90 | 99) 
Default 
-c99 


Description 


With this option you select the ISO C standard. C90 is also referred to as 
the "ANSI C standard”. C99 refers to the newer ISO/IEC 9899:1999 (E) 
standard. C99 is the default. 


Example 
To select the ISO C90 standard on the command line: 


ctc -c90 test.c 
ctc --iso-90 test.c 


Related information 


d> Compiler option -A (Language extensions) 


Tool Options - Compiler 


—--check 


EDE 


1. In the project window, select the file you want to check. 


2. From the Build menu, select Check Syntax. 


Command line syntax 
—-check 


Description 


With this option you can check the source code for syntax errors, without 
generating code. This saves time in developing your application. 


The compiler reports any warnings and/or errors. 
Example 
To check for syntax errors, without generating code: 
ctc --check test.c 
Related information 
d> Assembler option --check (Check syntax) 
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—-cse-all-addresses 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Miscellaneous. 
3. Add the option —-cse-all-addresses to the Additional options field. 


Command line syntax 


--cse-all-addresses 


Description 


With this option you tell the compiler to make all addresses available for 
common subexpression evaluation. 


Normally the compiler ignores __ near and __ ax addresses for common 
subexpressions. However, depending on the use of address registers and 
whether stack and/or addressed memory are internal or external, it might 
be wise to consider them for CSE. 


Example 
ctc --cse-all-addresses -Oc test.c 


The compiler makes all addresses available for common subexpression 
evaluation. 


Related information 


d> Compiler option -Oc (Common subexpression elimination) 


Tool Options - Compiler 


-D (—-define) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Preprocessing. 


3. Enter a macro name and/or definition in the Define user macros 
field. 


Use commas to separate multiple macro definitions. 


Command line syntax 


-Dmacro_name|zmacro_ definition] 
—-definezmacro_name|zmacro_definition] 


Description 


With this option you can define a macro and specify it to the preprocessor. 


If you only specify a macro name (no macro definition), the macro 
expands as '1l'. 


You can specify as many macros as you like. In EDE, use commas to 
separate multiple macro definitions. On the command line, use the 
option -D multiple times. If the command line exceeds the limit of the 
operating system, you can define the macros in an option file which you 
then must specify to the compiler with the option -f file. 


Defining macros with this option (instead of in the C source) is, for 
example, useful to compile conditional C source as shown in the example 
below. 


5-13 


5-14 TriCore Reference Manual 


- 


Example 


Consider the following C program with conditional code to compile a 
demo program and a real program: 


void main( void ) 


{ 
#if DEMO 

demo func(); /* compile for the demo program */ 
#else 

real func(); /* compile for the real program */ 
#endif 
} 


You can now use a macro definition to set the DEMO flag: 


ctc -DDEMO test.c 
ctc -DDEMO-1 test.c 


ctc --define=DEMO test.c 
ctc --define=DEMO=1 test.c 


Note that all four invocations have the same effect. 


The next example shows how to define a macro with arguments. Note that 
the macro name and definition are placed between double guotes because 
otherwise the spaces would indicate a new option. 


ctc —D”MAX(A,B)=((A) > (B) ? (A) : (B))” 
Related information 


d> Compiler option -U (Remove preprocessor macro) 
Compiler option -f (Specify an option file) 


Tool Options - Compiler 


—-diag 
EDE 


1. In the Help menu, enable the option Show Help on Tool Errors. 


2. In the Build tab of the Output window, double-click on an error or 
warning message. 


A description of tbe selected message appears. 


Command line syntax 


—-diag—[format:|all | number|,number)... ) 


Optionally, you can use one of the following display formats (format): 


text The default is plain text 

html Display explanation in HTML format 

rtf Display explanation in RTF format 
Description 


With this option the compiler displays a description and explanation of the 
specified error message(s) on stdout (usually the screen). The compiler 
does not compile any files. 


To create a file with the descriptions, you must redirect the output. 


With the suboption all, the descriptions of all error messages are given. If 
you want the description of one or more selected error messages, you can 
specify the error message numbers, separated by commas. 


With this option the compiler does not compile any files. 
Example 
To display an explanation of message number 282, enter: 
ctc —-diag-282 
This results in the following message and explanation: 


E282: unterminated comment 


Make sure that all every comment starting with /* has 
a matching */. Nested comments are not possible. 
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To write an explanation of all errors and warnings in HTML format to file 
cerrors.html, enter: 


ctc —-diag-html:all > cerrors.html 


Related information 


d> Section 5.8, C Compiler Error Messages, in Chapter Using the Compiler of 
the User’s Manual. 


Tool Options - Compiler 


-E (—-preprocess) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Preprocessing. 


3. Enable the option Store the C compiler preprocess output 
(<file>.pre). 


Command line syntax 
-E/flags| 
—-preprocess|=/lags| 


You can set the following flags (when you specify -E without flags, the 
default is -ECMP): 


c/C (+/-comments) Keep comments 

m/M (+/-make) Generate dependencies for make 

p/P (H/-noline) Strip #line source position info 
Description 


With this option you tell the compiler to preprocess the C source. EDE 
stores the preprocess output in the file name . pre (where name is the 
name of the C source file to compile). EDE also compiles the C source. 


On the command line, the compiler sends the preprocessed file to stdout. 
To capture the information in a file, specify an output file with the 
option —o. 


With -Ec you tell the preprocessor to keep the comments from the C 
source file in the preprocessed output. 


With -Em the compiler will generate dependency lines that can be used 
in a Makefile. The preprocessor output is discarded. 


With -Ep you tell the preprocessor to strip the #line source position 
information (lines starting with #line). These lines are normally 
processed by the assembler and not needed in the preprocessed output. 
When you leave these lines out, the output is easier to read. 


5-18 TriCore Reference Manual 


- 


Example 


ctc -ECMP test.c -o test.pre 


ctc --preprocess-rcomments,-make,-noline test.c 
—--output-test.pre 


The compiler preprocesses the file test.c and sends the output to the 
file test. pre. Comments are included but no dependencies are 
generated and the line source position information is not stripped from the 
output file. 


Related information 


J- 
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—-error-file 


EDE 


Command line syntax 
—-error-file|[—fi/e] 


Description 
With this option the compiler redirects error messages to a file. 


If you do not specify a filename, the error file will be named after the 
input file with extension .err. 


Example 


To write errors to errors.err instead of stderr, enter: 


ctc —-error-file-errors.err test.c 


Related information 


d> Compiler option --warnings-as-errors (Treat warnings as errors) 
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-F (—no-double) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Language. 
3. Enable the option Single precision floating-point only. 
Command line syntax 
-F 
--no-double 


Description 


With this option you tell the compiler to treat variables of the type double 
as float. Because the float type takes less space, execution speed 
increases and code size decreases, both at the cost of less precision. 


Example 
ctc -F test.c 
ctc --no-double test.c 


The file test.c is compiled where variables of the type double are 
treated as float. 


Related information 


J- 
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-f (—option-file) 


EDE 


1. From the Project menu, select Project Options... 

Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Miscellaneous. 
3. Add the option -f to the Addtional options field. 


In EDE you can save your options in a file and restore them to call the 
compiler with those options: 


e From the Project menu, select Save Options... or Load Options... 


Be aware that when you specify the option -f in the Additional options 
field, the options are added to the compiler options you have set in the 
Project Options dialog. Only in extraordinary cases you may want to use 
them in combination. 


Command line syntax 
-f file,... 


—-option-file—f//e,... 


Description 


Instead of typing all options on the command line, you can create an 
option file which contains all options and files you want to specify. With 
this option you specify the option file to the compiler. 


Use an option file when the length of the command line would exceed the 
limits of the operating system, or just to store options and save typing. 


You can specify the option -f multiple times. 
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Format of an option file 
e Multiple command line arguments on one line in the option file are 
allowed. 
e To include whitespace in an argument, surround the argument with 
single or double guotes. 
e If you want to use single quotes as part of the argument, surround the 
argument by double guotes and vise versa: 


"This has a single quote ' embedded” 
'This has a double guote ” embedded' 


‘This has a double quote ” and \ 
a single quote '”' embedded” 


e When a text line reaches its length limit, use a ^V to continue the line. 
Whitespace between guotes is preserved. 


"This is a continuation \ 
line” 
-> "This is a continuation line” 


e It is possible to nest command line files up to 25 levels. 


Example 
Suppose the file myoptions contains the following lines: 
-Ctcllib 
-s 
test.c 


Specify the option file to the compiler: 


ctc -f myoptions 
ctc --option-file=myoptions 


This is equivalent to the following command line: 


ctc -Ctcllib -s test.c 


Related information 


J- 


Tool Options - Compiler 


—-fpu-present 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Processor Definition. 


3. In the Target processor list select (user defined TriCore-1 v1.3) or 
(user defined TriCore-2). 


4. Enable the option FPU present. 


Command line syntax 


—-fpu-present 


Description 


With this option the compiler can generate single precision floating-point 
instructions in the assembly file. When you select this option, the macro 
__ FPU___ is defined in the C source file. 


& If you choose a valid target processor (command line option -C (—-cpu)), 
this option is automatically set, based on the chosen target processor. 


Example 


To allow the use of floating-point unit (FPU) instructions in the assembly 
code, enter: 


ctc —-fpu-present test.c 
Related information 
d> Compiler option —-is-tricore2 (Tricore2 instructions allowed) 


Compiler option -C (Use SFR definitions for CPU) 
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-g (—debug-info) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Debug Information. 
3. Enable the option Generate symbolic debug infomation 
Command line syntax 
-8 
—-debug-info 


Description 


With this option you tell the compiler to add directives to the output file 
for including symbolic information. This facilitates high level debugging 
but increases code size. For the final application, compile your C files 
without debug information. 


When you specify a high optimization level, the debug comfort may 
decrease. Therefore, the compiler issues warning W555 if the debug 
comfort would be decreased as a result of the chosen optimizations. 


Example 


To add symbolic debug information to the output file, enter: 


ctc -g test.c 
ctc —-debug test.c 


Related information 


d - 


Tool Options - Compiler 


-H (--include-file) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Preprocessing. 
3. Enter the name of the file in the Include this file before source field. 
Command line syntax 
-Hile,... 
—-include-file—fi/e,... 


Description 
With this option you include one extra file at the beginning of each C 
source file, before other includes. This is the same as specifying #include 
"file" atthe beginning of each of your C sources. 

Example 


ctc -Hstdio.h testl.c test2.c 
ctc --include-file-stdio.h testl.c test2.c 


The file stdio.h is included at the beginning of both test1.c and 
test2.c. 


Related information 
d> Compiler option -I (Add directory to include file search path) 


Section 5.5, How tbe Compiler Searcbes Imclude Files, in Chapter Using tbe 
Compiler of the User's Manual. 
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-I (—include-directory) 


EDE 


1. From the Project menu, select Directories... 
Tbe Directories dialog appears. 
2. Enter one or more search paths in the Include Files Path field. 
Command line syntax 
-Ipath,... 
—-include-directory=path,... 


Description 


With this option you can specify the path where your include files are 
located. A relative path will be relative to the current directory. 


The order in which the compiler searches for include files is: 


1. The pathname in the C source file and the directory of the C source 
(only for #include files that are enclosed in ””) 


2. The path that is specified with this option. 


3. The path that is specified in the environment variable CTCINC when 
the product was installed. 


4. The default directory $(PRODDIR) \include. 
Example 
Suppose that the C source file test. c contains the following lines: 


#include <stdio.h> 
#include "myinc.h” 


You can call the compiler as follows: 


ctc -Imyinclude test.c 
ctc —-include-directory-myinclude test.c 


First the compiler looks for the file stdio.h in the directory myinclude 
relative to the current directory. If it was not found, the compiler searches 
in the environment variable and then in the default include directory. 
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The compiler now looks for the file myinc.h in the directory where 
test.c is located. If the file is not there the compiler searches in the 
directory myinclude. If it was still not found, the compiler searches in the 
environment variable and then in the default include directory. 


Related information 
d> Compiler option -H (Include file at the start of a compilation) 


Section 5.5, How tbe Compiler Searcbes Imclude Files, in Chapter Using tbe 
Compiler of the User's Manual. 


Section 1.3.2, Configuring the Command Line Environment, in Chapter 
Software Installation of the User's Manual. 
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—-indirect 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Code Generation. 
3. Enable the option Call functions indirectly. 
Command line syntax 
—-indirect 


Description 


With this option you tell the compiler to generate code for indirect 
function calling. 


Example 
ctc —-indirect test.c 


The compiler generates far calls for all functions. 


Instead of this option you can also specify the following pragma in your C 
source: 


fpragma indirect 
Related information 
d> Compiler option —indirect-runtime 


See also section 3.9.3, Function Calling Modes: _ indirect, in Chapter 
TriCore C Language of the User's Manual. 


Tool Options - Compiler 


—-indirect-runtime 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the C Compiler entry and select Code Generation. 
3. Enable the option Call run-time functions indirectly. 
Command line syntax 
—-indirect-runtime 


Description 


With this option you tell the compiler to generate code for indirect calls to 
run-time functions. Use this option if you locate the entire run-time library 
in far memory. 


Example 
ctc —-indirect-runtime test.c 
The compiler generates far calls for all run-time functions. 


Instead of this option you can also specify the following pragma in your C 
source: 


#pragma indirect runtime 


Related information 
d> Compiler option —-indirect 


See also section 3.9.3, Function Calling Modes: _indirect, in Chapter 
TriCore C Language of the User's Manual. 
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—-inline 


EDE 


Command line syntax 


—-inline 


Description 


With this option you instruct the compiler to inline all functions, regardless 
whether they have the keyword inline or not. This option has the same 
effect as a #pragma inline at the start of the source file. 


& This option can be useful to increase the possibilities for code compaction 
(option -Or). 


Example 
To inline all functions: 
ctc --inline test.c 
Related information 


d> Compiler option -Or (Optimization: code compaction) 
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—-inline-max-incr / 
—-inline-max-size 


EDE 


Command line syntax 


—-inline-max-incr—perceniage 


—-inline-max-—size—/bresbold 


Default 


—-inline-max-incr-35 


—-inline—-max-size-10 


Description 


& 


With these options you can control the function inlining optimization 
process of the compiler. These options have only effect when you have 
enabled the inlining optimization (option —-Oî). 


Regardless of the optimization process, the compiler always inlines all 
functions that have the function gualifier inline. 


With the option —-inline—-max-size you can specify the maximum size of 
functions that the compiler inlines as part of the optimization process. The 
compiler always inlines all functions that are smaller than the specified 
threshold. The threshold is measured in compiler internal units and the 
compiler uses this measure to decide which functions are small enough to 
inline. The default threshold is 10. 


After the compiler has inlined all functions that have the function gualifier 
inline and all functions that are smaller than the specified threshold, the 
compiler looks whether it can inline more functions without increasing the 
code size too much. With the option —-inline-max-incr you can specify 
how much the code size is allowed to increase. By default, this is 3596 
which means that the compiler continues inlining functions until the 
resulting code size is 3596 larger than the original size. 
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Example 


ctc —-inline-max-incr-40 --inline-max-size-l5 test.c 


The compiler first inlines all functions with the function qualifier inline 
and all functions that are smaller than the specified threshold of 15. If the 
code size has still not increased with 4096, the compiler decides which 
other functions it can inline. 


Related information 
d> Compiler option -O (Specify optimization level) 


Section 3.9.1, Inlining Functions, in Chapter TriCore C Language of the 
User’s Manual. 
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—-integer-enumeration 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the C Compiler entry and select Language. 
3. Enable the option Use 32-bit integers for enumeration. 


Command line syntax 


—-integer-enumeration 


Description 


With this option you tell the compiler to use (32-bit) integers for 
enumerations. Without this option, the treats small enumerated types as a 
smaller integer, a char or even a __ bit type to reduce code size. 


Example 


To treat enumerated types always as 32-bit integer, enter: 


ctc —-integer-enumeration test.c 


Related information 


dh - 
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—-is-tricore2 


EDE 


1. From the Project menu, select Project Options... 

Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Processor Definition. 
3. In the Target processor list select (user defined TriCore-2). 


4. Optionally enable or disable the options FPU present and MMU 
present. 


Command line syntax 


—-is-tricore2 


Description 


With this option the compiler can generate TriCore 2 instructions in the 
assembly file. When you select this option, the macro __ TC2___ is defined 
in the C source file. 


& If you choose a valid target processor (command line option -C (—-cpu)), 
this option is automatically set, based on the chosen target processor. 


Example 
To allow the use of TriCore 2 instructions in the assembly code, enter: 


ctc —-is-tricore2 test.c 


Related information 


d> Compiler option —-fpu-present (Use hardware floating-point 
instructions) 
Assembler option --mmu-present (Allow use of MMU instructions) 


Compiler option -C (Use SFR definitions for CPU) 
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-k (—keep-output-files) 


EDE 


EDE always removes the . src file when errors occur during compilation. 


Command line syntax 
-k 


—-keep-output-files 


Description 


If an error occurs during compilation, the resulting . src file may be 
incomplete or incorrect. With this option you keep the generated output 
file (. src) when an error occurs. 


By default the compiler removes the generated output file (.src) when an 
error occurs. This is useful when you use the make utility mktc. If the 
erroneous files are not removed, the make utility may process corrupt files 
on a subsequent invocation. 


Use this option when you still want to inspect the generated assembly 
source. Even if it is incomplete or incorrect. 


Example 
ctc -k test.c 


When an error occurs during compilation, the generated output file 
test.src will not be removed. 


Related information 


Compiler option --warnings-as-errors (Treat warnings as errors) 
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—misrac 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select MISRA-C. 
3. Select a MISRA-C configuration. 
4. (Optional) In the MISRA-C Rules entry, specify the individual rules. 


Command line syntax 


--misrac={all | number |-number',... ) 


Description 


With this option you specify to the compiler which MISRA-C rules must be 
checked. With the option --misrac=all the compiler checks for all 
supported MISRA-C rules. 


Example 
ctc --misrac=9-13 test.c 


The compiler generates an error for each MISRA-C rule 9, 10, 11, 12 or 13 
violation in file test.c. 


Related information 
d> See Chapter 10 MISRA-C Rules for a list of all supported MISRA-C rules. 
Compiler option —--misrac-advisory-warnings 
Compiler option --misrac-reguired-warnings 
Compiler option --misrac-version 


Linker option --misra-c-report. 
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—misrac-advisory-warnings / 
—misrac-reguired-warnings 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select MISRA-C. 


3. Enable or disable the options Turn advisory rule violation into 
warning and/or Turn required rule violation into warning. 


Command line syntax 
—-misrac-advisory-warnings 
—-misrac-reguired-warnings 


Description 


Normally, if an advisory rule or reguired rule is violated, the compiler 
generates an error. As a conseguence, no output file is generated. With 
this option, the compiler generates a warning instead of an error. 


Example 
ctc --misrac=all —mmisrac-advisory-warnings test.c 


The compiler generates an error for each MISRA-C rule violation in file 
test.c. If one of the advisory rules is violated, a warning instead of an 
error is generated. 


Related information 


d> See Chapter 10 MISRA-C Rules for a list of all supported MISRA-C rules. 


Compiler option —-misrac 


5-38 


TriCore Reference Manual 


—misrac-version 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select MISRA-C. 
3. Select the MISRA-C version: MISRA-C:1998 or MISRA-C:2004. 


Command line syntax 
—-misrac—version—(1998 | 2004) 


Description 


MISRA-C rules exist in two versions: MISRA-C:1998 and MISRA-C:2004. By 
default, the C source is checked against the MISRA-C:2004 rules. With this 
option you can specify to check against the MISRA-C:1998 rules. 


Related information 


d> See Chapter 10 MISRA-C Rules for a list of all supported MISRA-C rules. 


Compiler option —-misrac 
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-N (—-default-near-size) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Allocation. 


3. Enable the option Default __ near allocations for objects below 
threshold and enter a threshold value. 


Command line syntax 
-N{threshold| 


--default-near-size|=(hreshold| 


Default 
-N8 


Description 


With this option you can specify a threshold value for __ near allocation. 
If you do not specify __ near or __ far in the declaration of an object, the 
compiler chooses where to place the object. The compiler allocates objects 
smaller or egual to the threshold in __ near sections. Larger objects are 


allocated in a0, alor _ far sections. 


The default threshold is eight bytes. 


If you specify -N without a threshold value, all objects will be allocated 


__ near, including arrays and string constants. 


Instead of this option you can also use #pragma default near size 


in the C source. 


Example 
ctc -N12 test.c 


Data elements smaller than or equal to 12 bytes are allocated in __ near 


sections. 
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Related information 


db 


Compiler option -Y (maximum size in bytes for data elements that are 
default located in __ a1 sections) 
Compiler option -Z (maximum size in bytes for data elements that are 
default located in __ a0 sections) 


Section 3.3.1, Declare a Data Object in a Special Part of Memory, in 
Chapter 77iCore C Language of the User's Manual. 
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-n (—sstdout) 


EDE 


Command line syntax 
-n 
—-stdout 


Description 


With this option you tell the compiler to send the output to stdout (usually 
your screen). No files are created. 


This option is for example useful to guickly inspect the output or to 
redirect the output to other tools. 


Example 


ctc -n test.c 


The compiler sends the output (normally test. src) to stdout and does 
not create the file test.src. 


Related information 


i- 
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—no-tasking-sfr 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Preprocessing. 
3. Disable the option Automatic inclusion of ’.sfr’ file. 
Command line syntax 
—-no-tasking—sfr 


Description 


Normally, the compiler includes a special function register (SFR) file before 
compiling. The compiler automatically selects the SFR file belonging to the 
target you select on the Processor definition page of the Processor 
options (compiler option -C). 


With this option the compiler does not include the register file 
regcpu.sfr as based on the selected target processor. 


Use this option if you want to use your own set of SFR files. 


Example 


ctc -Ctcllib --no-tasking-sfr test.c 
The register file regtcllib.sfr is not included. 


Related information 
d> Compiler option -C (Use SFR definitions for CPU) 
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-O (--optimize) 


EDE 


From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
Expand the C Compiler entry and select Optimization. 


Select an optimization level in the Optimization level box. 


Command line syntax 


-O[flaes] 
—-optimize|[—//ags] 


You can set the following flags: 


a/A (t/—-coalesce) Coalescer: remove unnecessary moves 
c/C (+/-cse) Common subexpression elimination 
e/E (+/-expression) Expression simplification 
f/F  (+/-flow) Control flow optimization and 
code reordering 
g/G (+/-glo) Generic assembly optimizations 
i/I (+/-inline) Function inlining 
k/K (t/-schedule) Instruction scheduler 
VL (4/-loop) Loop transformations 
m/M (+/-simd) Perform SIMD optimizations 
o/O (+/-forward) Forward store 
p/P (+/-propagate) Constant propagation 
s/S — (F/-subscript) Subscript strength reduction 
v/V (t/-ifconvert) Convert IF statements using predicates 
w/W (t/-pipeline) Software pipelining 
y/Y (+/-peephole) Peephole optimizations 


Use the following options for predefined sets of flags: 


-O0 (--optimize=0) No optimization. 
Alias for: -OACEFGIKLMOPSVWY 


No optimizations are performed. The compiler tries to achieve a 1-to-1 
resemblance between source code and produced code. Expressions are 
evaluated in the same order as written in the source code, associative 
and commutative properties are not used. 
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-O1 (--optimize=1) Debug purpose optimization 
Alias for: -OaCefgIKLMOPSVWy 


Enables optimizations that do not affect the debug—ability of the source 
code. Use this level when you are developing/debugging new source 
code. 


-02 (—-optimize-2) Release purpose optimization (default) 
Alias for: -OacefgIkIMopsvwy 


Enables more optimizations to reduce code size and/or execution time. 
The debugger can handle this code but the relation between source 
code and generated instructions may be hard to understand. Use this 
level for those modules that have already been debugged. This is the 
default optimization level. 


-03 (—-optimize-3) Aggressive optimization 
Alias for: -Oacefgiklmopsvwy 


Enables aggressive global optimization techniques. Although in theory 
debugging is still possible, the relation between source code and 
generated instructions is complex and hard to understand. Use this 
level to compress your program into the system memory, or to 
decrease execution time to meet your real-time requirements. 


Default 
-02 


Description 


With this option you can control the level of optimization. If you do not 
use this option, the default optimization level is medium optimization 
(option -O2 or -O or -OacefgIklMopsvwy). 


When you use this option to specify a set of optimizations, you can 
overrule these settings in your C source file with 
#pragma optimize flag and #pragma endoptimize. 


In addition to the option -O, you can specify the option —t. With this 
option you specify whether the used optimizations should optimize for 
more speed (regardless of code size) or for smaller code size (regardless of 
speed). 
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Example 


The following invocations are eguivalent and result all in the default 
medium optimization set: 


ctc 


ctc 
ctc 


ctc 
ctc 


ctc 
ctc 


test.c 

-O2 test.c 

—-optimize-2 test.c 

-O test.c 

—-optimize test.c 

-OacefgIklpswy test.c 
—-optimize=+coalesce,+cse,+expression,+flow, 


+glo,-inline,+schedule,+loop,+propagate, 
+subscript,+ifconvert,+pipeline,+peephole test.c 


Related information 


d> Compiler option -t (Trade off between speed (-t0) and size (-t4)) 


#pragma optimize flag 
#pragma endoptimize 


Section 5.3, Compiler Optimizations, in Chapter Using the Compiler of the 
User’s Manual. 
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-o (—-output) 


EDE 


Command line syntax 
—ofile 
—-output-fi/e 


Description 


With this option you can specify another filename for the output file of the 
compiler. Without this option the basename of the C source file is used 
with extension .src. 


EDE names the output file always after the C source file. 


Example 


ctc -o output.src test.c 
ctc —-output-output.src test.c 


The compiler creates the file output. src for the compiled file test.c. 


Without the option —o, like EDE, the compiler uses the names of the input 
file and creates test.src. 


Related information 


f- 


Tool Options - Compiler 


—--object-comment 


EDE 


1. From the Project menu, select Project Options... 

Tbe Project Options dialog box appears. 
2. Expand the C Compiler entry and select Miscellanaous. 
3. Add your comment to the Comment in object file field. 


Command line syntax 


--object-comment=comment 


Description 
With this option the compiler generates a .comment section at the end of 
the assembly file. The section contains the comment specified with this 
option. After assembling, this text is included in the .o object and .elf 
files. Place the comment between double quotes. 

Example 

ctc —-object-comment-”Created by TASKING” test.c 

The compiler creates the file test. src with a .comment section at the 


end of the file. After assembling this file, the text "Created by TASKING” is 
incorporated in the generated object file. 


Instead of this option you can also specify the following pragma in your C 
source: 


#pragma object comment comment 


Related information 


d - 
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-R (--rename-sections) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Miscellaneous. 
3. Add the option -R to the Addtional options field. 
Command line syntax 
-R [name] 
—-rename-sections|=name] 


Description 


The compiler defaults to a section naming convention, using a prefix 
indicating the section type, the module name and a symbol name: 


section_type_pref.module_name.symbol_name 
For example .text.module_name.symbol_name for code sections. 


If a module must be loaded at a fixed address or if a data section needs a 
special place in memory, you can use the -R option to generate a different 
section name (section type_pref.name where name replaces the part 
module name.symbol_name). You can now use the new unique section 
name in the linker script file for locating. 


When you use -R without a value, the compiler uses the default section 
naming. 


Example 


To generate the section name section type pref .NEW instead of the 
default section name section Iype_pref.module_name.symbol name, enter: 


ctc -RNEW test.c 


To generate the section name section _type_pref instead of the default 
section name section_type_pref.module_name.symbol name, enter: 


ctc -R” ” test.c (note the space between the quotes) 
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Related information 


d> Section 3.10, Compiler Generated Sections, in Chapter T7iCore C Language 
of the User's Manual. 
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-s (—-source) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Miscellaneous. 


3. Enable the option Merge C source code with assembly in output 
file (.src). 


Command line syntax 
=S 
——SOUurcc 


Description 


With this option you tell the compiler to merge C source code with 
generated assembly code in the output file. The C source lines are 
included as comments. 


Example 


ctc -s test.c 


The output file test. src contains the original C source lines as 
comments, besides the generated assembly code. 


Related information 


J- 
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—-section-per-data-object 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Code Generation. 
3. Enable the option Generate a section for each data object. 
Command line syntax 


—-section-per-data-object 


Description 


Normally the compiler generates one section for each data type in a 
module (such as .data, .rodata, .bss, .zdata, ...). 


With this option you force the compiler to generate a separate section for 
each data object. This provides more control about allocation during the 
linking process. 


Example 


ctc —-section-per-data-object test.c 


For each data object in test.c the compiler generates a separate section. 


Related information 


i- 
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—-silicon-bug 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Bypasses. 


3. Select the bypasses you want to enable. 


Command line syntax 


—-silicon-bug—drg,... 
You can give one or more of the following arguments: 


all-tcllib All TriCore TC11IB workarounds 
all-tc1130 All TriCore TC1130 workarounds 
all-tc1765 All TriCore TC1765 workarounds 
all-tc1766 All TriCore TC1766 workarounds 
all-tc1775 All TriCore TC1775 workarounds 
all-tc1796 All TriCore TC1796 workarounds 
all-tc1910 All TriCore TC1910 workarounds 
all-tc1912 All TriCore TC1912 workarounds 
all-tc1920 All TriCore TC1920 workarounds 


cpu-tc013 workaround for CPU TC.013 (#pragma CPU_ TC013) 
cpu-tc018 workaround for CPU TC.018 (#pragma CPU TC018 ) 
cpu-tc021 workaround for CPU TC.021 (#pragma CPU_TCO21 ) 
cpu-tc024 workaround for CPU TC.024 (#pragma CPU_TC024 ) 
cpu-tc030 workaround for CPU_TC.030 (#pragma CPU_TC030) 
cpu-tc031 workaround for CPU_TC.031 (#pragma CPU TC031) 
cpu-tc033 workaround for CPU TC.033 (#pragma CPU_ TC033) 
cpu-tc034 workaround for CPU TC.034 (#pragma CPU_TC034) 
cpu-tc048 workaround for CPU_TC.048 (#pragma CPU_TC048) 
cpu-tc050 workaround for CPU_TC.050 (#pragma CPU_TC050) 
cpu-tc060 workaround for CPU_TC.060 (#pragma CPU_TC060) 
cpu-tc065 workaround for CPU_TC.065 (#pragma CPU_TC065) 
cpu-tc069 workaround for CPU_TC.069 (#pragma CPU_TC069) 
cpu-tc070 workaround for CPU TC.070 (#pragma CPU_ TC070) 
cpu-tc071 workaround for CPU TC.071 (#pragma CPU_ TC071) 
cpu-tc072 workaround for CPU TC.072 (#pragma CPU_ TCO72) 
dmu-tc001 workaround for DMU_TC.001 (pragma DMU TC001) 
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Description 


With this option you tell the compiler to use software workarounds for 
some CPU functional problems. 


Example 
ctc —-silicon-bug-cpu-tc021,cpu-tc030 test.c 


The compiler uses workarounds for problems CPU_TC.024 and 
CPU_TC.030. 


Related information 


d> See Chapter 9, CPU Functional Problems, for more information about the 
individual problems and workarounds. 


Assembler option —-silicon-bug 


#pragma CPU functional problem 
#pragma DMU functional problem 


5-54 TriCore Reference Manual 


—-static 


EDE 


Command line syntax 


—-—static 


Description 


With this option, the compiler treats external definitions at file scope 
(except for main) as if they were declared static. As a result, unused 
functions will be eliminated, and the alias checking algorithm assumes that 
objects with static storage cannot be referenced from functions outside the 
current module. 


This option only makes sense when you specify all modules of an 
application on the command line. 


Example 


ctc —-static modulel.c module2.c module3.c 


Related information 


J- 
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—-switch 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Code generation. 


3. Select an Algorithm for switch statments. 


Command line syntax 


—-switch—arg 


You can give one of the following arguments: 


auto Choose most optimal code 

jumptab Generate jump tables 

linear Use linear jump chain code 

lookup Generate lookup tables 
Default 


--switch=auto 


Description 


With this option you tell the compiler which code must be generated for a 
switch statement: a jump chain (linear switch), a jump table or a lookup 

table. By default, the compiler will automatically choose the most efficient 
switch implementation based on code and data size and execution speed. 


Example 


ctc —-switch-jumptab test.c 


The compiler uses a table filled with target addresses for each possible 
switch value. 


Instead of this option you can also specify the following pragma in your C 
source: 


#pragma switch jumptab 
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Related information 


d> See also section 3.11, Switch Statement, in Chapter TriCore C Language of 
the User's Manual. 
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-t (--tradeoff) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Optimization. 
3. Select a trade-off level in the Size/speed trade-off box. 
Command line syntax 
-t{0|1|2|3|4} 
—-tradeoff=(0 | 1|2|3| 4 


Default 
-t2 


Description 


If the compiler uses certain optimizations (option —-O), you can use this 
option to specify whether the used optizations should opimize for more 
speed (regardless of code size) or for smaller code size (regardless of 
speed). 


Default the compiler balances speed and size while optimizing (-t0). 


& If you have not used the option -O, the compiler uses default medium 
optimization, so you can still specify the option —t. 


Example 
To set the trade-off level for the used optimizations: 


ctc -t4 test.c 
ctc —-tradeoff-4 test.c 


The compiler uses the default medium optimization level and optimizes 
for code size rather than for speed. 


Related information 


d> Compiler option -O (Specify optimization level) 
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-U (—-undefine) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Miscellaneous. 
3. Add the option -U to the Additional compiler options field. 
Command line syntax 
-Umdacro_name 
--undefine=macro_name 


Description 


With this option you can undefine an earlier defined macro as with 
#undef. 


This option is for example useful to undefine predefined macros. 
The following predefined ISO C standard macros cannot be undefined: 


__ FILE current source filename 

_ LINE__ current source line number (int type) 
__TIME__ hh:mm:ss 

_ DATE__ Mmm dd yyyy 

_ STDC__ level of ANSI standard 


Example 
To undefine the predefined macro __ TASKING__: 


ctc -U_ TASKING test.c 
ctc --undefine=_ TASKING test.c 


Related information 


d> Compiler option -D (Define macro) 


Section 3.8, Predefined Macros, in Chapter Using the Compiler of the User's 
Manual. 
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-u (--uchar) 


EDE 
1. From the Project menu, select Project Options... 


Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Language. 
3. Enable the option Treat ’char’ variables as unsigned instead of 
signed. 
Command line syntax 
—u 
—-uchar 


Description 


Treat 'character' type variables as 'unsigned character' variables. By default 
char is the same as specifying signed char. With -u char is the same 
asunsigned char. 


Example 
With the following command char is treated as unsigned char: 


ctc -u test.c 
ctc --uchar test.c 


Related information 


J- 
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-V (--version) 


EDE 


Command line syntax 
-V 


—-version 


Description 


Display version information. The compiler ignores all other options or 
input files. 


Example 


ctc —v 
ctc —-version 


The compiler does not compile any files but displays the following version 
information: 


TASKING TriCore VX-toolset C compiler vxx.yrz Build 000 
Copyright 2002-year Altium BV Serial# 00000000 


Related information 


J- 
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-w (—-no-warnings) 


EDE 


From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
Expand the C Compiler entry and select Warnings. 


Enable one of the options Report all warnings, Suppress all 
warnings, or Suppress specific warnings. 


If you select Suppress specific warnings: 


Enter the numbers, separated by commas, of the warnings you want to 
suppress. 


Command line syntax 


—w|[mn7| 


--no-warnings[—7'| 


Description 


With this option you can suppresses all warning messages or specific 
warning messages. 


If you do not specify this option, all warnings are reported. 

If you specify this option but without numbers, all warnings are 
suppressed. 

If you specify this option with a number, only the specified warning is 
suppressed. You can specify the option —w multiple times. 


Example 


To suppress all warnings: 


ctc test.c -w 
ctc test.c --no-warnings 


To suppress warnings 135 and 136: 


ctc test.c -w135 -w136 
ctc test.c --no-warnings=135 --no-warnings=136 
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Related information 


d> Compiler option --warnings-as-errors (Treat warnings as errors) 
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—-warnings-as-errors 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Warnings. 


3. Enable the option Treat warnings as errors. 


Command line syntax 


—-warnings-as-errors 


Description 


With this option you tell the compiler to treat warnings as errors. 


Example 


ctc —-warnings-as-errors test.c 


When a warning occurs, the compiler considers it as an error. 


Related information 


d> Compiler option —w (suppress some or all warnings) 
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-Y (—-default-a1-size) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Allocation. 


3. Enable the option Default _ a1 allocations for objects below 
threshold and enter a threshold value. 


Command line syntax 
-Z|tbresbold) 


--default-a1-size[=ihreshold| 


Default 
-YO 


Description 


With this option you can specify a threshold value for __ a0 allocation. If 
you do not specify a memory qualifier such as __ near or __ far in the 
declaration of an object, the compiler chooses where to place the object 
based on the size of the object. 


First, the size of the object is checked against the -N threshold, according 
to the description of the -N option. If the size is larger than the -N 
threshold, but lower or equal to the -Y threshold, the object is allocated in 
__al memory. Larger objects, arrays and strings will be allocated __ far. 


The default -Y threshold is zero, which means that the compiler will never 
use __ a1 memory unless you specify the -Y option. When you use the 
-Y option without a threshold value, all objects not allocated __ near, 
including arrays and string constants, will be allocated in __ a1 memory. 


Allocation in __ a1 memory means that the object is addressed indirectly, 
using A1 as the base pointer. The total amount of memory that can be 
addressed this way is 64 Kbytes. 


Instead of this option you can also use #pragma default a1_size in the C 
source. 
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Example 
ctc -Y12 test.c 


Data elements smaller than or equal to 12 bytes are allocated in __al 
sections. 


Related information 


Compiler option -Z (max size (in bytes) for rodata elements located in 
__al sections) 


Compiler option -N (maximum size in bytes for data elements that are 
default located in __ near sections) 


Section 3.3.1, Declare a Data Object in a Special Part of Memory, in 
Chapter 777Core C Language of the User's Manual. 
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-Z (—-default-aO-size) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select Allocation. 


3. Enable the option Default _ a0 allocations for objects below 
threshold and enter a threshold value. 


Command line syntax 
-Z\threshold| 


--default-a0-size|[=ihreshold]| 


Default 
-Z0 


Description 


With this option you can specify a threshold value for __a0 allocation. If 
you do not specify a memory qualifier such as __near or __ far in the 
declaration of an object, the compiler chooses where to place the object 
based on the size of the object. 


First, the size of the object is checked against the -N threshold, according 
to the description of the -N option. If the size is larger than the -N 
threshold, but lower or equal to the -Z threshold, the object is allocated in 
__ a0 memory. Larger objects, arrays and strings will be allocated __ far. 


The default -Z threshold is zero, which means that the compiler will never 
use __ a0 memory unless you specify the -Z option. When you use the -Z 
option without a threshold value, all objects not allocated __ near, 
including arrays and string constants, will be allocated in __ a0 memory. 


Allocation in __ a0 memory means that the object is addressed indirectly, 
using A0 as the base pointer. The total amount of memory that can be 
addressed this way is 64 Kbytes. 


Instead of this option you can also use #pragma default a0 size in the C 
source. 
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Example 
ctc -Z12 test.c 


Data elements smaller than or equal to 12 bytes are allocated in __ a0 
sections. 


Related information 


Compiler option -Y (max size (in bytes) for data elements located in __ a0 
sections) 


Compiler option -N (maximum size in bytes for data elements that are 
default located in __ near sections) 


Section 3.3.1, Declare a Data Object in a Special Part of Memory, in 
Chapter 777Core C Language of the User's Manual. 
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5.2. ASSEMBLER OPTIONS 


This section lists all assembler options. 


Options in EDE versus options on the command line 


Most command line options have an eguivalent option in EDE but some 
options are only available on the command line. If there is no eguivalent 
option in EDE, you can specify a command line option in EDE as follows: 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Miscellaneous. 


3. Enter one or more command line options in the Additional options 
field. 


Be aware that some command line options are not useful in EDE or just 
do not have any effect. For example, the option -V displays version 
header information and has no effect in EDE. 


Sbort and long option names 


Options have both short and long names. Short option names always 
begin with a single minus (—) character, long option names always begin 
with two minus (—-) characters. You can abbreviate long option names as 
long as it forms a unigue name. You can mix short and long option names 
on the command line. 


Options can have flags or suboptions. To switch a flag 'on', use a 
lowercase letter or a -Hongflag. To switch a flag off, use an uppercase 
letter or a —Jongflag. Separate longflags with commas. The following two 
invocations are eguivalent: 


astc -Lmx test.src 
astc --list-format=+macro,+macro-expansion test.src 


When you do not specify an option, a default value may become active. 
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-? (--help) 


EDE 


Command line syntax 
-? 


--help|=options] 


Description 


Displays an overview of all command line options. When you specify the 
options argument, a list with option descriptions is displayed. 


Example 


The following invocations all display a list of the available command line 
options: 


astc —? 
astc —-help 
astc 


The following invocation displays extended information about all options: 


astc —-help-options 


Related information 


f- 
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-C (--cpu) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Processor Definition. 


3. In the Target processor list select the target processor. 


Command line syntax 
—Ccpu 


—-cpu—cpu 


Description 
With this option you define the target processor for which you create your 
application. 


Based on the target processor the assembler automatically detects whether 
a MMU or FPU-unit is present and whether the architecture is a TriCore2. 
This means you do not have to specify the assembler options 
—--mmu-present, —fpu-present and —-is-tricore2 explicitly when one 
of the supported derivatives is selected. 


The assembler automatically includes the register file regcpu.def, unless 
you specify assembler option —-no-tasking-—sfr. 
Example 
In EDE, the target CPU has the following settings: 
e Target processor: TC11IB 


To define this on the command line: 


astc -Ctcllib test.src 
astc --cpu=tcllib test.src 


The assembler assembles test. src for the TC11IB processor and 
includes the register file regtcllib.de£. Furthermore the assembler 
allows MMU instructions to be used. 
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To avoid conflicts, make sure you specify the same target processor as you 
did for the compiler. 


Related information 
d> Assembler option —-no-tasking-sfr (Do not include .def file) 


Compiler option -C (Use SFR definitions for CPU) 
Control program option -C (Use SFR definitions for CPU) 


Section 6.4, Calling the Assembler, in Chapter Using the Assembler of the 
User’s Manual. 


5-72 TriCore Reference Manual 


- 


-c (--case-insensitive) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Miscellaneous. 
3. Disable the option Assemble case sensitive. 
Command line syntax 
=c 
—-case-insensitive 


Description 


With this option you tell the assembler not to distinguish between upper 
and lower case characters. By default the assembler considers upper and 
lower case characters in labels and user-defined symbols as different 
characters. Note that instruction mnemonics, register names, directives and 
controls are always treated case insensitive. 


& Disabling the option Assemble case sensitive in EDE is the same as 
specifying the option —c on the command line. 


Assembly source files that are generated by the compiler must always be 
assembled case sensitive. When you are writing your own assembly code, 
you may want to specify the case insensitive mode. 


Example 
To assemble case insensitive: 


astc -c test.src 
astc —-case-insensitive test.src 


The assembler considers upper and lower case characters as being the 
same. So, for example, the label LabelName is the same label as 
labelname. 


Related information 


d> Linker option —-case-sensitive (Link case insensitive) 
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—--check 


EDE 


1. In the project window, select the file you want to check. 


2. From the Build menu, select Check Syntax. 


Command line syntax 
—-check 


Description 


With this option you can check the source code for syntax errors, without 
generating code. This saves time in developing your application. 


The assembler reports any warnings and/or errors. 
Example 
To check for syntax errors, without generating code: 
astc --check test.src 
Related information 
d> Compiler option --check (Check syntax) 
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-D (—-define) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Preprocessing. 


3. Enter a macro name and/or definition in the Define user macros 
field. 


Use commas to separate multiple macro definitions. 


Command line syntax 


-Dmacro_name|zmacro_ definition] 
—-definezmacro name|zmacro_definition] 


Description 


With this option you can define a macro and specify it to the assembler 
preprocessor. If you only specify a macro name (no macro definition), the 
macro expands as ’1’. 


You can specify as many macros as you like. In EDE, use commas to 
separate multiple macro definitions. On the command line you can use the 
option -D multiple times. If the command line exceeds the limit of the 
operating system, you can define the macros in an option file which you 
then must specify to the assembler with the option -ffile. 


Defining macros with this option (instead of in the assembly source) is, for 
example, useful in combination with conditional assembly as shown in the 
example below. 


& This option has the same effect as defining symbols via the . SET, and 
. EOU directives. (similar to #define in the C language). With the . MACRO 
directive you can define more complex macros. 
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Example 


Consider the following C program with conditional code to compile a 
demo program and a real program: 


-IF DEMO == 1 

bee ; instructions for demo application 
- ELSE 

eae ; instructions for the real application 
- ENDIF 


You can now use a macro definition to set the DEMO flag: 


astc -DDEMO test.src 
astc -DDEMO-1 test.src 


astc —--define-DEMO test.src 
astc -—-define=DEMO=1 test.src 


Note that all four invocations have the same effect. 
Related information 
d> Assembler option -f (Specify an option file) 


Section 4.10.5, Conditional Assembly, in Chapter TriCore Assembly 
Language of the User's Manual. 
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—-diag 
EDE 


1. In the Help menu, enable the option Show Help on Tool Errors. 


2. In the Build tab of the Output window, double-click on an error or 
warning message. 


A description of tbe selected message appears. 


Command line syntax 


—-diag—[format:|all | number|,number)... ) 


Optionally, you can use one of the following display formats (format): 


text The default is plain text 

html Display explanation in HTML format 

rtf Display explanation in RTF format 
Description 


With this option you can ask for an extended description of error 
messages in the format you choose. The output is directed to stdout 
(normally your screen) and in the format you specify. 


To create a file with the descriptions, you must redirect the output. 


With the suboption all, the descriptions of all error messages are given. If 
you want the description of one or more selected error messages, you can 
specify the error message numbers, separated by commas. 


With this option the assembler does not assemble any files. 
Example 
To display an explanation of message number 241, enter: 
astc —-diag-241 
This results in the following message and explanation: 


W241: additional input files will be ignored 


The assembler supports only a single input file. All 
other input files are ignored. 
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To write an explanation of all errors and warnings in HTML format to file 
aserrors.html, enter: 


astc —-diag-html:all > aserrors.html 


Related information 


d> Section 6.7, Assembler Error Messages, in Chapter Using the Assembler of 
the User’s Manual. 
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—-emit-locals 


EDE 


Command line syntax 


—--emit-locals 


Description 


With this option the assembler also emits local symbols to the object file's 
symbol table. Normally, only global symbols are emitted. 


Example 


To emit local symbols, enter: 


astc —--emit-locals test.src 


Related information 


J- 
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—-error-file 


EDE 


Command line syntax 
—-error-file|[—fi/e] 


Description 
With this option the assembler redirects error messages to a file. 


If you do not specify a filename, the error file will be named after the 
input file with extension .ers. 


Example 


To write errors to errors.ers instead of stderr, enter: 


astc —--error-file-errors.ers test.src 


Related information 


d> Assembler option —--warnings-as-errors (Treat warnings as errors) 
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-f (—option-file) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Miscellaneous. 


3. Add the option -f to the Additional options field. 


In EDE you can save your options in a file and restore them to call the 
assembler with those options: 


1. From the Project menu, select Save Options... or Load Options... 


Be aware that when you specify the option -f in the Additional options 
field, the options are added to the assembler options you have set in the 
Project Options dialog. Only in extraordinary cases you may want to use 
them in combination. 


Command line syntax 
-f file,... 


—-option-file—fi/e,... 


Description 


Instead of typing all options on the command line, you can create an 
option file which contains all options and files you want to specify. With 
this option you specify the option file to the assembler. 


Use an option file when the length of the command line would exceed the 
limits of the operating system, or just to store options and save typing. 


You can specify the option -f multiple times. 
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Format of an option file 
* Multiple command line arguments on one line in the option file are 
allowed. 
e To include whitespace in an argument, surround the argument with 
single or double guotes. 
e If you want to use single quotes as part of the argument, surround the 
argument by double guotes and vise versa: 


"This has a single quote ' embedded” 
'This has a double guote ” embedded' 


‘This has a double quote ” and \ 
a single quote '”' embedded” 


Note that adjacent strings are concatenated. 


e When a text line reaches its length limit, use a ^V to continue the line. 
Whitespace between guotes is preserved. 


"This is a continuation \ 
line” 
-> "This is a continuation line” 


e It is possible to nest command line files up to 25 levels. 


Example 


Suppose the file myoptions contains the following lines: 


-Ctcllib 
test.src 


Specify the option file to the assembler: 


astc -f myoptions 
astc —-option-file-myoptions 


This is eguivalent to the following command line: 


astc -Ctcllib test.src 


Related information 


L 
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—-fpu-present 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Processor Definition. 
3. In the Target processor list select a (user defined TriCore) option. 
4. Enable the option FPU present. 


Command line syntax 


—-fpu-present 


Description 


With this option you can use single precision floating—point instructions in 
the assembly code. When you select this option, the define _ FPU __ is set 
to 1. By default the define _ FPU __ is set to 0. 


Example 


To allow the use of floating-point unit (FPU) instructions in the assembly 
code, enter: 


astc --fpu-present test.src 
Related information 


d> Assembler option -C (Select CPU) 
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-g (--debug-info) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Assembler entry and select Debug Information. 


3. Enable one or more debug options. 


You cannot use Assembly source line information and Pass HLL 
debug information simultaneously. 


Command line syntax 
-glflag] 
—-debug-info|[—f/ag| 


You can set the following flags: 


a/A  (P/-asm) Assembly source line information 
h/H (t/-hll) Pass HLL debug information 
UVL (4/-local) Local symbols debug information 
s/S — (F/-smart) Smart debug information 

Default 
-gs 

Description 


With this option you tell the assembler to generate debug information. If 
you do not use this option or if you specify -g without any flags, the 
default is —gs. 


You cannot specify -gah. Either the assembler generates assembly source 
line information, or it passes HLL debug information. 


When you specify -gs, the assembler selects which flags to use. If high 
level language information is available in the source file, the assembler 
passes this information (same as -gAhL). If not, the assembler generates 
assembly source line information and local symbols debug information 
(same as -gaHl). 
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- 


With -gAHLS the assembler does not generate any debug information. 
Example 
To disable symbolic debug information, turn all flags off: 


astc -gAHLS test.src 
astc —-debug-info--asm,-hll,-local,-smart test.src 


To enable smart debugging, enter: 


astc -gs test.src 
astc —-debug-info-tsmart test.src 


Related information 


J- 
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-H (--include-file) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Assembler entry and select Preprocessing. 
3. Enter the name of the file in the Include this file before source field. 
Command line syntax 
-Hile,... 
—-include-file—fi/e,... 


Description 


With this option you include one extra file at the beginning of the 
assembly source file, before other includes. This is the same as specifying 
- INCLUDE 'file' at the beginning of your assembly sources. 


Example 


astc -Hmyinc.inc testl.src 
astc —-include-file-myinc.inc testl.src 


The file myinc. inc is included at the beginning of test1.src before it 
is assembled. 


Related information 
d> Assembler option -I (Add directory to include file search path) 


Section 6.5, How the Assembler Searches Include Files, in Chapter Using the 
Assembler of the User’s Manual. 
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-I (—include-directory) 


EDE 


1. From the Project menu, select Directories... 
Tbe Directories dialog appears. 
2. Enter one or more search paths in the Include Files Path field. 
Command line syntax 
-Ipath,... 
—-include-directory=path,... 


Description 


With this option you can specify the path where your include files are 
located. A relative path will be relative to the current directory. 


The order in which the assembler searches for include files is: 


1. The absolute pathname, if specified in the . INCLUDE directive. Or, if 
no path or a relative path is specified, the same directory as the source 
file. 


2. The path that is specified with this option. 


3. The path that is specified in the environment variable ASTCINC when 
the product was installed. 


4. The default include directory relative to the installation directory. 


Example 


Suppose that your assembly source file test. src contains the following 
line: 


INCLUDE ‘myinc.inc’ 
You can call the assembler as follows: 


astc —Ic:\proj\include test.src 
astc -——include-directory=c:\proj\include test.src 
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First the assembler looks in the directory where test. src is located for 
the file myinc. inc. If it does not find the file, it looks in the directory 
c:\proj\include for the file myinc. inc (this option). 


Related information 


d> Section 6.5, How the Assembler Searches Include Files, in Chapter Using the 
Assembler of the User's Manual. 


Section 1.3.2, Configuring the Command Line Environment, in Chapter 
Software Installation of the User’s Manual. 


Assembler option -H (Include file at the start of the input files) 
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-i (--symbol-scope) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Miscellaneous. 
3. Select the default label mode: Local or Global. 
Command line syntax 
-iíg |D 
--symbol-scope=(global | local) 
Default 
-il 


Description 
With this option you tell the assembler how to treat symbols that you have 
not specified explicitly as global or local. 


By default the assembler treats all symbols as local symbols unless you 
have defined them explicitly as global. 


Example 


astc -ig test.src 
astc —--symbol-scope-global test.src 


The assembler treats all symbols as global symbols unless they are defined 
as local symbols in the assembly source file. 


Related information 


f- 
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—-is-tricore2 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Processor Definition. 


3. In the Target processor list select (user defined TriCore-2). 


Command line syntax 


—-is-tricore2 


Description 


With this option you can use TriCore 2 instructions in the assembly code. 
When you select this option, the define_ TC2__ is set to 1. 


Example 


To allow the use of TriCore 2 instructions in the assembly code, enter: 


astc --is-tricore2 test.src 


Related information 


d> Assembler option -C (Select CPU) 
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-k (—keep-output-files) 


EDE 


EDE always removes the .o file when errors occur during assembly. 


Command line syntax 
-k 


—-keep-output-files 


Description 


If an error occurs during assembly, the resulting . o file may be incomplete 
or incorrect. With this option you keep the generated object file (. o) 
when an error occurs. 


By default the assembler removes the generated object file (.o) when an 
error occurs. This is useful when you use the make utility mktc. If the 
erroneous files are not removed, the make utility may process corrupt files 
on a subsequent invocation. 


Use this option when you still want to use the generated object. For 
example when you know that a particular error does not result in a 
corrupt object file. 


Example 
astc -k test.src 


When an error occurs during assembly, the generated output file test.o 
will not be removed. 


Related information 


d> Assembler option --warnings-as-errors (Treat warnings as errors) 
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-L (—-list-format) 


EDE 


1. From the Project menu, select Project Options... 


Tbe Project Options dialog appears. 


2. Expand the Assembler entry and select List File. 


3. Enable the options to include that information in the list file. 


Command line syntax 
-Lflags 


—-list-format=/lags 


You can set the following flags: 


0 
1 


c/C 
d/D 
e/E 
g/G 
i/I 
1/L 
m/M 
n/N 
p/P 
g/O 
r/R 
v/V 
w/W 
x/X 
y/Y 


Default 


same as -LCDEGILMNPORVWXY 
same as -Lcdegilmnpgrvwxy 


(+/-control) Assembler controls 

(+/-section) Section directives 

(+/-symbol) Symbol definition directives 
(+/-generic-expansion) Generic instruction expansion 
(+/-generic) Generic instructions 

(+/-line) #line source lines 

(+/-macro) Macro definitions 
(+/-empty-line) Empty source lines 
(+/-conditional) Conditional assembly 
(+/-equate) Assembler .EQU and .SET directives 
(+/-relocations) Relocation characters (r) 
(+/-equate-values) Assembler .EQU and .SET values 
(+/-wrap-lines) Wrapped source lines 
(+/-macro-expansion) Macro expansions 
(+/-cycle-count) Cycle counts 


-LcDEGilMnPgrVWXy 
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Description 


With this option you specify which information you want to include in the 
list file. Use this option in combination with the option -1 (—-list-file). 


If you do not specify this option, the assembler uses the default: 
-LcDEGilMnPgrVWXy. 


With option —tl, the assembler also writes section information to the list 
file. 


Example 


astc -l -Ldm test.src 
astc —-list-file —-list-format-rsection,-*tmacro 
test.src 


The assembler generates a list file that includes all default information plus 
section directives and macro definitions. 


Related information 


d> Assembler option -1 (Generate list file) 
Assembler option -tl (Display section information in list file) 


Linker option -M (Generate map file) 


Section 6.1, Assembler List File Format, in Chapter List File Formats. 
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-I (—-list-file) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Assembler entry and select List File. 
3. Enable the option Generate list file. 
Command line syntax 
-1 
—-list-file 


Description 


With this option you tell the assembler to generate a list file. A list file 
shows the generated object code and the relative addresses. Note that the 
assembler generates a relocatable object file with relative addresses. 


Example 


To generate a list file with the name test.1st, enter: 


astc -l test.src 
astc —--list-file test.src 


Related information 
d> Assembler option -L (List file formatting options) 
Linker option -M (Generate map file) 


Section 6.1, Assembler List File Format, in Chapter List File Formats. 
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-m (—-preprocessor-type) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Preprocessing. 
3. Select No preprocessor or the TASKING preprocessor. 
Command line syntax 
-min |t) 
--preprocessor-type—(none | tasking} 


Default 


-mt 


Description 
With this option you select the preprocessor that the assembler will use. 
By default, the assembler uses the TASKING preprocessor. 


When the assembly source file does not contain any preprocessor 
symbols, you can specify the assembler not to use a preprocessor. 


Example 


astc test.src 
astc -mt test.src 
astc --preprocessor=tasking test.src 


These invocations have the same effect: the assembler preprocesses the 
file test. src with the TASKING preprocessor. 


Related information 


f- 
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——-mmu-present 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Processor entry and select Processor Definition. 


3. In the Target processor list select (user defined TriCore-1 v1.3) or 
(user defined TriCore-2). 


4. Enable the option MMU present. 


& This option is only available (and relevant) for specific target processors. 
See option -C (—-cpu) to select a target processor. 
Command line syntax 


--mmu-present 


Description 


With this option you can use memory management instructions in the 
assembly code. When you select this option, the define_ MMU___ is set to 
1. 


Example 


To allow the use of memory management unit (MMU) instructions in the 
assembly code, enter: 


astc —-mmu-present test.src 


Related information 
d> Assembler option -C (Select CPU) 
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—-no-tasking-sfr 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Preprocessing. 
3. Disable the option Include ’.def file. 
Command line syntax 
—-no-tasking—sfr 


Description 


Normally, the assembler includes a special function register (SFR) file 
before compiling. The assembler automatically selects the SFR file 
belonging to the target you select on the Processor definition page of 
the Processor options (assembler option -C). 


With this option the assembler does not include the register file 
regcpu.def as based on the selected target processor. 


Use this option if you want to use your own set of SFR ’.def files. 


Example 


astc -Ctcllib --no-tasking-sfr test.src 


The register file regtcllib.def is not included, but the assembler allows 
the use of MMU instructions due to -C. 


Related information 
d> Assembler option -C (Select CPU) 
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-O (--optimize) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Assembler entry and select Optimization. 


3. Enable or disable the optimization suboptions. 


Command line syntax 
-Oflags 


--optimize=/lags 


You can set the following flags: 


g/G (t/-generics) Allow generic instructions 
s/S — (F/-instr-size) Optimize instruction size 
Default 
-Ogs 
Description 


With this option you can control the level of optimization. If you do not 
use this option, -Ogs is the default. 


Example 
The following invocations are equivalent and result all in the default 
optimizations: 


astc test.src 
astc -0gs test.src 
astc —-optimize-rgenerics,tinstr-size test.src 


Related information 


Section 6.3, Assembler Optimizations, in Chapter Using the Assembler of the 
User's Manual. 
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-o (—-output) 


EDE 


Command line syntax 
—ofile 
—-output-fi/e 


Description 


With this option you can specify another filename for the output file of the 
assembler. Without this option, the basename of the assembly source file is 
used with extension .o. 


EDE names the output file always after the assembly source file. 


Example 


astc -o relobj.o asm.src 
astc --output=relobj.o asm.src 


The assembler creates the file relobj .o for the assembled file asm. src. 


Without the option —o, like EDE, the assembler uses the name of the input 
file and creates asm.o. 


Related information 


f- 
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—-silicon-bug 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Bypasses. 


3. Select the CPU functional problems you want to check for. 


Command line syntax 


—-silicon-bug—drg,... 
You can give one or more of the following arguments: 


all-tc11ib All TriCore TC11IB checks 
all-tc1130 All TriCore TC1130 checks 
all—tc1765 All TriCore TC1765 checks 
all-tc1766 All TriCore TC1766 checks 
all-tc1775 All TriCore TC1775 checks 
all-tc1796 All TriCore TC1796 checks 
all-tc1910 All TriCore TC1910 checks 
all-tc1912 All TriCore TC1912 checks 
all-tc1920 All TriCore TC1920 checks 


cpu-tc013 check for CPU_TC.013 
cpu-tc018 check for CPU_TC.018 
cpu-tc021 check for CPU_TC.021 
cpu-tc023 check for CPU_TC.023 
cpu-tc024 check for CPU_TC.024 
cpu-tc030 check for CPU_TC.030 
cpu-tc031 check for CPU_TC.031 
cpu-tc033 workaround for CPU_TC.033 
cpu-tc034 check for CPU_TC.034 
cpu-tc048 check for CPU_TC.048 
cpu-tc050 check for CPU_TC.050 
cpu-tc051 workaround for CPU_TC.051 
cpu-tc060 check for CPU_TC.060 
cpu-tc065 check for CPU_TC.065 
cpu-tc069 check for CPU_TC.069 
cpu-tc070 check for CPU_TC.070 
cpu-tc071 check for CPU_TC.071 
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cpu-tc072 check for CPU_TC.072 
dmu-tc001 check for DMU_TC.001 
pmi-tc003 workaround for PMI_TC.003 
pmu-tc004 workaround for PMU_TC.004 


Description 


With this option you tell the assembler to check for some CPU functional 
problems. The assembles gives a warning when the specified problem is 
present. 


Example 
astc —-silicon-bug-cpu-tc021,cpu-tc030 test.src 


The assembler checks for problems CPU_TC.024 and CPU_TC.030 and 
gives a warning when the problem is present. 


Related information 


d> See Chapter 9, CPU Functional Problems, for more information about the 
individual problems. 


Compiler option —-silicon-bug 
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-t (--section-info) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Assembler entry and select List File. 
3. Enable the option Generate list file. 
4. Enable the option Display section information. 
EDE always writes the section information to the list file. 
Command line syntax 
—t/lags 
—-section-info—f/ags 


You can set the following flags: 


c/C (+/-console) Display section information on stdout. 
VL (4/-list) Write section information to the list file. 
Description 


With this option you tell the assembler to display section information. For 
each section its memory space, size, total cycle counts and name is listed 
on stdout and/or in the list file. 


The cycle count consists of two parts: the total accumulated count for the 
section and the total accumulated count for all repeated instructions. In the 
case of nested loops it is possible that the total supersedes the section 
total. 


With —tl, the assembler writes the section information to the list file. You 
must specify this option in combination with the option -1 (generate list 
file). 
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- 


Example 


astc -l -tcl test.src 
astc -l --section-info=+console,+list test.src 


The assembler generates a list file and writes the section information to 
this file. The section information is also displayed on stdout. 


Section summary: 


REL 4 .Zbss_ clr testl 
REL 46 .text_testl 
REL 4 .zdata rom testl 


Related information 
d> Assembler option -1 (Generate list file) 


Tool Options - Assembler 5-103 


-V (--version) 


EDE 


Command line syntax 
-V 


—-version 


Description 


Display version information. The assembler ignores all other options or 
input files. 


Example 


astc -V 
astc --version 


The assembler does not assemble any files but displays the following 
version information: 


TASKING TriCore VX-toolset Assembler vxx.yrz Build nnn 
Copyright years Altium BV Serial# 00000000 


Related information 


de- 
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-w (—-no-warnings) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Warnings. 


3. Enable one of the options Report all warnings, Suppress all 
warnings, or Suppress specific warnings. 


If you select Suppress specific warnings: 


4. Enter the numbers, separated by commas, of the warnings you want to 
suppress. 
Command line syntax 


—w([n7,...] 


--no-warnings[—77,...] 


Description 
With this option you can suppresses all warning messages or specific 
warning messages. 
* If you do not specify this option, all warnings are reported. 


e If you specify this option but without numbers, all warnings are 
suppressed. 


e If you specify this option with a number, only the specified warning is 
suppressed. You can specify the option —w multiple times. 


Example 


To suppress all warnings: 


astc -w test.src 
astc —-no-warnings test.src 


To suppress warnings 135 and 136: 


astc -wl35,136 test.src 
astc —-no-warnings-135,136 test.src 
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Related information 


d> Assembler option —-—-warnings-as-errors (Treat warnings as errors) 


5-106 TriCore Reference Manual 


- 


—-warnings-as-errors 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Assembler entry and select Warnings. 


3. Enable the option Treat warnings as errors. 


Command line syntax 


—-warnings-as-errors 


Description 


With this option you tell the assembler to treat warnings as errors. 
Example 
astc —-warnings-as-errors test.src 


When a warning occurs, the assembler considers it as an error. No object 
file is generated, unless you specify option -k (--keep-output-files). 


Related information 


d> Assembler option —w (suppress some or all warnings) 
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5.3_ LINKER OPTIONS 


Options in EDE versus options on the command line 


db 


Most command line options have an equivalent option in EDE but some 
options are only available on the command line. EDE invokes the linker 
via the control program. Therefore, it uses the syntax of the control 
program to pass options and files to the linker. 


See section 5.4, Control Program Options. 
If necessary, you can specify a command line option in EDE. 
1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 


3. Enter one or more command line options in the Additional options 
field. 


Because EDE uses the control program, EDE automatically precedes the 
option witb -WI to pass tbe option via the control program directly to the 
linker. 


For example, if you enter the option -DDEMO in the Additional 
options field, EDE generates tbe option -WI-DDEMO for the control 
program which tells the control program to pass the option -DDEMO to 
the linker. 


Be aware that some options are not useful in EDE or just will not have any 
effect. For example, the option -k keeps files after an error occurred. 
When you specify this option in EDE, it will have no effect because EDE 
always removes the output file after an error had occurred. 


Sbort and long option names 


Options can have both short and long names. Short option names always 
begin with a single minus (—) character, long option names always begin 
with two minus (—-) characters. You can abbreviate long option names as 
long as it forms a unigue name. You can mix short and long option names 
on the command line. 
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Options can have flags or suboptions. To switch a flag 'on', use a 
lowercase letter or a -Hongflag. To switch a flag off, use an uppercase 
letter or a -longflag. Separate longflags with commas. The following two 
invocations are eguivalent: 


ltc -mfkl test.o 
ltc --map-file-format=+files,+link,+locate test.o 


When you do not specify an option, a default value may become active. 
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-? (--help) 


EDE 


Command line syntax 
-? 
--help|=options] 
Description 
Displays an overview of all command line options. When you specify the 
argument options you can list detailed option descriptions. 
Example 
The following invocations all display a list of the available command line 


options: 


ltc -? 
ltc —-help 
ltc 
To see a detailed description of the available options, enter: 


ltc --help=options 


Related information 


J- 
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-c (--chip-output) 


EDE 
1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Output Format. 
3. Enable one or more output formats. 
4. Enable the option Create file for each memory chip. 
For some output formats you can specify a number of suboptions. 
Command line syntax 
—c[|basename]|:formal|:addr_size],... 
--chip-output=[basename):formal|:addr_size),... 
You can specify the following formats: 


IHEX Intel Hex 
SREC Motorola S-records 


The addr_size specifies the size of the addresses in bytes (record length). 
For Intel Hex you can use the values: 1, 2 and 4 (default). For Motorola S 
you can specify: 2 (S1 records), 3 (S2 records, default) or 4 bytes (S3 
records). 


Description 


With this option you specify the Intel Hex or Motorola S-record output 
format for loading into a PROM-programmer. The linker generates a file 
for each ROM memory defined in the LSL file, where sections are located: 


memory memname 
( type=rom; } 


The name of the file is the name of the EDE project or, on the command 
line, the name of the memory device that was emitted with extension 
.hex or .sre. Optionally you can specify a basename which prepends 
the generated file name. 
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Examples 


To generate Intel Hex output files for each defined memory, enter the 
following on the command line: 


ltc -cmyfile:IHEX testl.o 
ltc --chip-output=myfile:IHEX testl.o 


This generates the file myfile memname.hex. 


Related information 
d> Linker option —o (output file), 


Section 7.2, Motorola S-Record Format, 
Section 7.3, Intel Hex Record Format, in Chapter Object File Formats. 
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—-case-insensitive 


EDE 
1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 
3. Disable the option Link case sensitive. 


Command line syntax 


—-case-insensitive 


Description 


With this option you tell the linker not to distinguish between upper and 
lower case characters in symbols. By default the linker considers upper 
and lower case characters as different characters. 


& Disabling the option Link case sensitive in EDE is the same as specifying 
the option --case-insensitive on the command line. 


Assembly source files that are generated by the compiler must always be 
assembled and thus linked case sensitive. When you have written your 
own assembly code and specified to assemble it case insensitive, you must 
also link the .o file case insensitive. 

Example 


To link case insensitive: 
ltc --case-insensitive test.o 


The linker considers upper and lower case characters as being the same. 
So, for example, the label LabelName is considered the same label as 
labelname. 


Related information 


d> Assembler option —c (Assemble case insensitive) 
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-D (—-define) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog box appears. 
2. Expand the Linker entry and select Miscellaneous. 


3. Add the option -D to the Additional options field. 


Command line syntax 


-Dmacro_name|zmacro_ definition] 
—-definezmacro_name|zmacro_definition] 


Description 


With this option you can define a macro and specify it to the linker LSL 
file preprocessor. If you only specify a macro name (no macro definition), 
the macro expands as ’1’. 


You can specify as many macros as you like: you can use the option -D 
multiple times. If the command line exceeds the limit of the operating 
system, you can define the macros in an option file which you then must 
specify to the linker with the option —ffile. 


Define macro to the preprocessor, as in #define. Any number of symbols 
can be defined. The definition can be tested by the preprocessor with #if, 
#ifdef and #ifndef, for conditional locating. 

Example 


To define the RESET vector, interrupt table start address and trap table start 
address which is used in the linker script file tclv1_3.1s1, enter: 


ltc test.o -otest.elf -dtclv1_3.lsl -DRESET-0xa0000000 
-DINTTAB-0xa00f0000 —-define-TRAPTAB-0xa00f2000 


Related information 
d> Linker option -f (Name of invocation file) 
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-d (—-lsl-file) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Script File. 


3. Select Use project specific memory and section LSL file and specify 
a name. 


Command line syntax 


-dfile 
—-lsl-file—fi/e 


Description 


With this option you specify a linker script file to the linker. If you do not 
specify this option, the linker uses a default script file. You can specify the 
existing file target. lsl or the name of a manually created linker script 
file. You can use this option multiple times. The linker processes the LSL 
files in the order in which they appear on the command line. 


The linker script file contains vital information about the core for the 
locating phase of the linker. A linker script file is coded in LSL and 
contains the following types of information: 

e the architecture definition describes the core’s hardware architecture. 
e the memory definition describes the physical memory in the system. 


e the section layout definition describes how to locate sections in 
memory. 


Example 


To read linker script file information from file tclv1_3.1s1: 


ltc -dtclv1_3.lsl test.o 
ltc --lsl-file=tclvl_3.1sl test.o 
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Related information 
d> Linker option —-lsl-check (Check LSL file(s) and exit) 


Section 7.7, Controlling the Linker with a Script in Chapter Linker of the 
User’s Manual. 
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—-diag 
EDE 


1. In the Help menu, enable the option Show Help on Tool Errors. 


2. In the Build tab of the Output window, double-click on an error or 
warning message. 


A description of tbe selected message appears. 


Command line syntax 


—-diag—[format:|all | number|,number)... ) 


Optionally, you can use one of the following display formats (format): 


text The default is plain text 

html Display explanation in HTML format 

rtf Display explanation in RTF format 
Description 


With this option you can ask for an extended description of error 
messages in the format you choose. The output is directed to stdout 
(normally your screen) and in the format you specify. 


To create a file with the descriptions, you must redirect the output. 


With the suboption all, the descriptions of all error messages are given. If 
you want the description of one or more selected error messages, you can 
specify the error message numbers, separated by commas. 


With this option the linker does not link any files. 
Example 
To display an explanation of message number 106, enter: 
ltc --diag=106 
This results in the following message and explanation: 
E106: unresolved external: message 
The linker could not resolve all external symbols. This is an 


error when the incremental linking option is disabled. The 
<message> indicates the symbol that is unresolved. 
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To write an explanation of all errors and warnings in HTML format to file 
lerrors.html, enter: 


ltc --diag=html:all > lerrors.html 


Related information 


d> Section 7.10, Linker Error Messages, in Chapter Using the Linker of the 
User's Manual. 
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-e (--extern) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 


3. Add the option —e in the Additional options field. 


Command line syntax 


—e symbol 
--extern=symbol 


Description 


With this option you force the linker to consider the given symbol as an 
undefined reference. The linker tries to resolve this symbol, either the 
symbol is defined in an object file or the linker extracts the corresponding 
symbol definition from a library. 


This option is, for example, useful if the startup code is part of a library. 
Because your own application does not refer to the startup code, you can 
force the startup code to be extracted by specifying the symbol _ START as 
an unresolved external. 


Example 


Consider the following invocation: 
ltc mylib.a 


Nothing is linked and no output file will be produced, because there are 
no unresolved symbols when the linker searches through mylib.a. 


ltc -e (START mylib.a 
ltc --extern=_START mylib.a 


In this case the linker searches for the symbol _START in the library and 
(if found) extracts the object that contains _START, the startup code. If this 
module contains new unresolved symbols, the linker looks again in 
mylib.a. This process repeats until no new unresolved symbols are 
found. 
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Related information 


d> Section 7.4.1, Specifying Libraries to tbe Linker, in Chapter Using tbe Linker 
of the User's Manual. 
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—-error-file 


EDE 


Command line syntax 
—-error-file|[—fi/e] 


Description 
With this option the linker redirects error messages to a file. 


If you do not specify a filename, the error file is ltc.elk. 


Example 


ltc --error-file=my.elk test.o 


The linker writes error messages to the file my. elk instead of stderr. 


Related information 


d> Linker option --warnings-as-errors (Treat warnings as errors) 
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-f (—option-file) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 

2. Expand the Linker entry and select Miscellaneous. 

3. Add the option -f to the Additional options field. 


Be aware that when you specify the option -f in the Additional options 
field, the options are added to the linker options you have set in the 
Project Options dialog. Only in extraordinary cases you may want to use 
them in combination. 


& In EDE you can save your options in a file and restore them to call the 
linker with those options: 


1. From the Project menu, select Save Options... or Load Options... 


Command line syntax 


-f file,... 
—-option-file—fi/e,... 


Description 


Instead of typing all options on the command line, you can create an 
option file which contains all options and files you want to specify. With 
this option you specify the option file to the linker. 


Use an option file when the length of the command line would exceed the 
limits of the operating system, or just to store options and save typing. 


You can specify the option -f multiple times. 


Format of an option file 
e Multiple command line arguments on one line in the option file are 
allowed. 
e To include whitespace in an argument, surround the argument with 
single or double guotes. 
e If you want to use single quotes as part of the argument, surround the 
argument by double guotes and vise versa: 
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"This has a single quote ' embedded” 
'This has a double guote ” embedded' 


‘This has a double quote ” and \ 
a single quote '”' embedded” 


Note that adjacent strings are concatenated. 


e When a text line reaches its length limit, use a ’\’ to continue the line. 
Whitespace between guotes is preserved. 


"This is a continuation \ 
line” 
-> "This is a continuation line” 


e It is possible to nest command line files up to 25 levels. 
Example 


Suppose the file myoptions contains the following lines: 


-Mmymap (generate a map file) 
test.o (input file) 
-Lc:Amylibs (additional search path for system libraries) 


Specify the option file to the linker: 


ltc -f myoptions 
ltc --option-file=myoptions 


This is eguivalent to the following command line: 
ltc -Mmymap test.o -Lc:Amylibs 


Related information 


J- 
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—-first-library first 


EDE 


Command line syntax 
—-first-library-first 


Description 


When the linker processes a library it searches for symbols that are 
referenced by the objects and libraries processed so far. If the library 
contains a definition for an unresolved reference the linker extracts the 
object that contains the definition from the library. 


By default the linker processes object files and libraries in the order in 
which they appear on the command line. If you specify the option 
—-first-library-first the linker always tries to take the symbol definition 
from the library that appears first on the command line before scanning 
subseguent libraries. 


This is for example useful when you are working with a newer version of 
a library that partially overlaps the older version. Because they do not 
contain exactly the same functions, you have to link them both. However, 
when a function is present in both libraries, you may want the linker to 
extract the most recent function. 


Example 
ltc —-first-library-first a.a test.o b.a 


If the file test. o calls a function which is both present in a.a and b.a, 
normally the function in b.a would be extracted. With this option the 
linker first tries to extract the symbol from the first library a.a. 


Related information 


d> Linker option >-no-rescan (Do not rescan libraries) 
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-I (—include-directory) 


EDE 


Command line syntax 
-Ipath,... 


—-include-directory=path,... 


Description 


With this option you can specify the path where your LSL include files are 
located. A relative path will be relative to the current directory. 


The order in which the linker searches for LSL include files is: 


1. The pathname in the LSL file and the directory where the LSL files are 
located (only for #include files that are enclosed in ””) 


2. The path that is specified with this option. 


3. The default $(PRODDIR) \include.1s1 directory relative to the 
installation directory. 


Example 
Suppose that the LSL file lslfile.lsl contains the following lines: 
#include "“mypart.lsl” 
You can call the linker as follows: 


ltc -Imyinclude -dlslfile.lsl test.o 


ltc --include-directory=myinclude 
—-lsl-file-lslfile.lsl test.o 


First the linker looks in the directory where lslfile.lsl is located for 
the file mypart.1s1. If it does not find the file, it looks in myinclude 
subdirectory relative to the current directory for the file mypart.1s1 (this 
option). Finally it looks in the directory $(PRODDIR)XNinclude.lsl. 


Related information 


d> Linker option -d (Linker script file) 
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(--user-provided-initialization-code) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 


3. Disable the option Use standard copy-table for initialization. 


Command line syntax 


=i 
—-user-provided-initialization-code 


Description 


It is possible to use your own initialization code, for example, to save 
ROM space. With this option you tell the linker 7701 to generate a copy 
table for initialize/clear sections. Use linker labels in your source code to 
access the positions of the sections when located. 


If the linker detects references to the TASKING initialization code, an error 
is emitted: it is either the TASKING initialization routine or your own, not 
both. 


Note that the options --no-rom-copy and —non-romable, may vary 
independently. The 'copytable-compression' optimization is automatically 
disabled when you enable this option. 


Example 


To link with your own startup code: 


ltc -i test.o 
ltc --user-provided-initialization-code test.o 


Related information 


J- 
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-k (—keep-output-files) 


EDE 


EDE always removes the output files when errors occurred. 


Command line syntax 


-k 
—-keep-output-files 


Description 


If an error occurs during linking, the resulting output file may be 
incomplete or incorrect. With this option you keep the generated output 
files when an error occurs. 


By default the linker removes the generated output files when an error 
occurs. This is useful when you use the make utility mktc. If the 
erroneous files are not removed, the make utility may process corrupt files 
on a subseguent invocation. 


Use this option when you still want to use the generated file. For example 
when you know that the error(s) do not result in a corrupt output file, or 
when you want to inspect the output file, or send it to Altium support. 


Example 


ltc -k test.o 
ltc --keep-output-files test.o 


When an error occurs during linking, the generated output file test.elf 
will not be removed. 


Related information 


f- 
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-L (—-library-directory / 
—-ignore-default-library-path) 


EDE 


1. From the Project menu, select Directories... 
Tbe Directories dialog appears. 
2. Add a pathname in the Library Files Path ficld. 


3. In the Library Files Path field, add the pathnames of the directories 
where the linker should look for library files. 


If you enter multiple paths, separate them with a semicolon (;). 


Command line syntax 


-Lpath,... 
—-library-directory=path,... 


-L 
—-ignore-default-library-path 


Description 


With this option you can specify the path(s) where your system libraries, 
specified with the -1 option, are located. If you want to specify multiple 
paths, use the option -L for each separate path. 


The default path is $ PRODDIR)XMlib. 


If you specify only -L (without a pathname) or the long option 
—-ignore-default-library-path, the linker will not search the default 
path and also not in the paths specified in the environment variable 
LIBTC1V1_2, LIBTC1V1 3 or LIBTC2. So, the linker ignores steps 2, 3 and 
4 as listed below. 


The priority order in which the linker searches for system libraries 
specified with the -I option is: 


1. The path that is specified with the -L option. 


2. The path that is specified in the environment variable LIBTC1V1_2, 
LIBTC1V1_3 or LIBTC2 when the product was installed. 
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3. The default directory $(PRODDIR)\ lib. 
4. The processor specific directory, for example $(PRODDIR) \lib\tcl. 
Example 
Suppose you call the linker as follows: 
ltc test.o -Lc:Amylibs -lc 


First the linker looks in the directory c:Xmylibs for library libc.a (this 
option). 


If it does not find the reguested libraries, it looks in the directory that is set 
with the environment variable LIBTC1V1_2, LIBTC1V1_3 or LIBTC2. 


Then the linker looks in the default directory $ (PRODDIR)NLib for 
libraries. 


Related information 


d> Linker option -l1 (Link system library) 


Section 7.4.2, How the Linker Searches Libraries, in Chapter Using the 
Linker of the User’s Manual. 


Section 1.3.2, Configuring the Command Line Environment, in Chapter 
Software Installation of the User’s Manual. 
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-I (—-library) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Libraries. 


3. Enable the option Link default C libraries. 


Command line syntax 


-Iname 
—-library=name 


Description 


With this option you tell the linker to search also in system library 
libname.a, where name is a string. The linker first searches for system 
libraries in any directories specified with —Lpath, then in the directories 
specified with the environment variable LIBTC1V1_2, LIBTC1V1_3 or 
LIBTC2, unless you used the option -L without a directory. 


& If you use the libc.a library, you must always link the libfp. a library 
as well. Remember that the order of the specified libraries is important! 


Example 
To search in the system library libfp.a (floating-point library): 


ltc test.o mylib.a -lfp 
ltc test.o mylib.a —-library-fp 


The linker links the file test.o and first looks in mylib.a (in the current 
directory only), then in the system library 1ibfp. a to resolve unresolved 
symbols. 


Related information 
d> Linker option -L (Additional search path for system libraries) 


Section 7.4.1, Specifying Libraries to tbe Linker, in Chapter Using tbe Linker 
of the User’s Manual. 
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—-link-only 


EDE 


Command line syntax 
—-link—-only 


Description 


With this option you suppress the locating phase. The linker stops after 
linking. The linker complains if any unresolved references are left. 


Example 
ltc --link-only hello.o 


The linker checks for unresolved symbols and creates the file task1.out. 


Related information 


d> Control program option —cl (Stop after linking) 
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—-lsl-check 


EDE 


Command line syntax 
—-Isl-check 


Description 


With this option the linker just checks the syntax of the LSL file(s) and 
exits. No linking or locating is performed. 


Example 
To check the LSL file(s) and exit: 


ltc --lsl-check —-lsl-file-mylslfile.lsl 
Related information 
d> Linker option -d (Linker script file) 
Linker option —-lIsl-dump (Dump LSL info) 


Chapter 8, Linker Script Language. 
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—-lsl-dump 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Script File. 


3. Enable the option Dump processor and memory info from LSL 
file. 


Command line syntax 
—-Isl-dump[-fi/e] 


Description 


With this option you tell the linker to dump the LSL part of the map file in 
a separate file, independent of the -M (generate map file) option. If you 
do not specify a filename, the file ltc.1df is used. 


Example 
ltc --lsl-dump=mydump.ldf test.o 


The linker dumps the processor and memory info from the LSL file in the 
file mydump.ldf. 


Related information 


d> Linker option -m (Map file formatting options) 
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-M (--map-file) 


EDE 
1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Map File. 
3. Enable the option Generate a map file (.map). 


Command line syntax 
-M(file] 
--map-file[—fi/e] 

Description 


With this option you tell the linker to generate a linker map file. If you do 
not specify a filenam and you specified the -o option, the linker uses the 
same basename as the output file with the extension .map.. If you did not 
specify the -o option, the linker uses the file task1.map. 


A linker map file is a text file that shows how the linker has mapped the 
sections and symbols from the various object files (. o) to the linked object 
file. A locate part shows the absolute position of each section. External 
symbols are listed per space with their absolute address, both sorted on 
symbol and sorted on address. 


With the option -m (map file formatting) you can specify which parts you 
want to place in the map file. 


Example 
To generate a map file (test .map): 


ltc -Mtest.map test.o 
ltc --map-file=test.map test.o 


The control program by default tells the linker to generate a map file. 
Related information 
d> Linker option -m (Map file formatting options) 


Section 6.2, Linker Map File Format, in Chapter List File Formats. 
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-m (--map-file-format) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Map File. 


3. Enable the options to include that information in the map file. 


Command line syntax 
—mflags 
--map-file-format=/lags 
You can set the following flags: 


0 same as -mcfkLMoOrSU (link info) 
1 same as -mCfKlMoORSU (locate info) 


2 same as -mcfklmoOrSu (most info) 
c/C (t/-callgraph) Call graph info 
f/F  (t/-files) Processed files info 
k/K (t/-link) Link result info 
VL — (d/-locate) Locate result info 
m/M (+/-memory) Memory usage info 
o/O (+/-overlay) Overlay info 
g/O — (F/-statics) Module local symbols 
r/R (t/—crossref) Cross references info 
s/S — (F/-lsl) Processor and memory info 
u/U (+/-rules) Locate rules 

Default 
-m2 

Description 


With this option you specify which information you want to include in the 
map file. Use this option in combination with the option -M 
(--map-file). If you do not specify this option, the linker uses the 
default: -m2 
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Example 


ltc -Mtest.map -mF test.o 
ltc --map-file=test.map 
—-map-file-format--files test.o 


The linker generates the map file test .map that includes all default 
information, but not the processed files part. 


Related information 
d> Linker option -M (Generate map file) 


Section 6.2, Linker Map File Format, in Chapter List File Formats. 
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—misra-c-report 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the C Compiler entry and select MISRA-C. 
3. Select a MISRA-C configuration. 
4. Enable the option Produce a MISRA-C report. 
Command line syntax 
--misra-c-report|=/i/e] 


Description 


With this option you tell the linker to create a MISRA-C Quality Assurance 
report. This report lists the various modules in the project with the 
respective MISRA-C settings at the time of compilation. If you do not 
specify a filename, the file name.mcr is used. 


Example 


ltc --misra-c-report test.o 


The linker creates a MISRA-C report file test .mcr. 


Related information 


d> Compiler option —-misrac 
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—munch 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 
3. Add the option --munch to the Additional options field. 


Command line syntax 


--munch 


Description 


With this option you tell the linker to activate the muncher in the 
pre-locate phase. 


The data sections are initialized when the application is downloaded. The 
data sections are not re-initialized when the application is restarted. 


Example 


ltc --munch test.o 


The linker activates the muncher in the pre-locate phase while linking the 
file test.o. 


Related information 


d>- 
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-N (—no-rom-copy) 


EDE 
1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 


3. Add the option -N to the Additional options field. 


Command line syntax 
-N 
--no-rom-copy 

Description 


With this option the linker will not generate a ROM copy for data sections. 
A copy table is generated and contains entries to clear BSS sections. 
However, no entries to copy data sections from ROM to RAM are placed in 
the copy table. 


The data sections are initialized when the application is downloaded. The 
data sections are not re-initialized when the application is restarted. 


Example 


ltc -N test.o 
ltc —-no-rom-copy test.o 


The linker does not generate ROM copies for data sections. 


Related information 


d>- 
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—--no-rescan 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Libraries. 


3. Disable the option Rescan libraries to solve unresolved externals. 


Command line syntax 


—-no-rescan 


Description 


When the linker processes a library, it searches for symbol definitions that 
are referenced by the objects and libraries processed so far. If the library 
contains a definition for an unresolved reference, the linker extracts the 
object that contains the definition from the library. The linker processes 
object files and libraries in the order in which they appear on the 
command line. 


When all objects and libraries are processed the linker checks if there are 
unresolved symbols left. If so, the default behavior of the linker is to 
rescan all libraries in the order given on the command line. The linker 
stops rescanning the libraries when all symbols are resolved, or when the 
linker could not resolve any symbol(s) during the rescan of all libraries. 
Notice that resolving one symbol may introduce new unresolved symbols. 


With this option, you tell the linker to scan the object files and libraries 
only once. When the linker has not resolved all symbols after the first 
scan, it reports which symbols are still unresolved. This option is useful if 
you are building your own libraries. The libraries are most efficiently 
organized if the linker needs only one pass to resolve all symbols. 


Example 
To scan the libraries only once: 
ltc --no-rescan test.o a.a b.a 


The linker resolves all unresolved symbols while scanning the object files 
and libraries and reports all remaining unresolved symbols after this scan. 
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Related information 


d> Linker option —-first-library-first (Scan libraries in the specified order) 
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——non-romable 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 

2. Expand the Linker entry and select Miscellaneous. 

3. Add the option to the Additional options field. 


Command line syntax 


--non-romable 


Description 


With this option the linker will locate all ROM sections in RAM. A copy 
table is generated and is located in RAM. When the application is started, 
that data and BSS sections are re-initialized. 


Example 


ltc --non-romable test.o 


The linker locates all ROM sections in RAM. 


Related information 


d>- 
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-O (--optimize) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Optimization. 
3. Enable or disable the optimization suboptions. 
Command line syntax 
—Oflags 
—-optimize-//ags 
You can set the following flags: 


c/C (+/-delete-unreferenced-sections) 
Delete unreferenced sections from the output file 
(no effect on sources compiled with debug information) 


VL | ("/-first-fit-decreasing) 
Use a 'first fit decreasing' algorithm to locate 
unrestricted sections in memory. 


s/S (+/-delete-unreferenced-symbols) 
Delete unreferenced symbols from the output file 


t/T (4/-copytable-compression) 
Locate (unrestricted) sections in such a way that 
the size of the copy table is as small as possible. 


x/X (+/-delete-duplicate-code) 
Delete duplicate code sections from the output file 


y/Y (P/-delete-duplicate-data) 
Delete duplicate constant data sections from the output file 


Use the following options for predefined sets of flags: 


-O0 (--optimize=0) No optimization. 
Alias for: -OCLSTXY 
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-O1 (—-optimize-l) Normal optimization (default). 
Alias for: -OCLStXY 


-O2 (—-optimize-2) All optimizations. 
Alias for: -Oclstxy 


Default 
-O1 


Description 


With this option you can control the level of optimization. If you do not 
use this option, -OCLStXY (—O1) is the default. 


Example 


The following invocations are eguivalent and result all in the default 
optimizations. 


ltc test.o 

ltc -O test.o 

ltc -01 test.o 

ltc -OCLStXY test.o 


ltc --optimize test.o 

ltc --optimize=1 test.o 

ltc --optimize--delete-unreferenced-sections, 
-first-fit-decreasing,tcopytable-compression, 
-delete-duplicate-code,-delete-duplicate-data test.o 


Related information 


d> Section 7.2.3, Linker Optimizations, in Chapter Using the Linker of the 
User’s Manual. 
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-o (--output) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Linker entry and select Output Format. 
3. Enable one or more output formats. 
For some output formats you can specify a number of suboptions. 


EDE and the control program name the output file always after the first 
input file with the extension .elf£. 


Command line syntax 


-olfilename]||:format|:addr_size]|,space_name]|... 
—-output-[///ename]l:formai|:addr size||yspace_name|]... 
You can specify the following formats: 


ELF ELF/DWARF 

IEEE IEEE-695 

IHEX Intel Hex 

SREC Motorola S-records 


Description 


By default, the linker generates an output file in ELF/DWARF format, with 
the name taskl.elf. 


With this option you can specify an alternative filename, and an alternative 
output format. The default output format is the format of the first input 
file. 


You can use the -o option multiple times. This is useful to generate 
multiple output formats. With the first occurrence of the -o option you 
specify the basename (the filename without extension), which is used for 
subsequent -o options with no filename specified. If you do not specify a 
filename, or you do not specify the -o option at all, the linker uses the 
default basename taskn. 
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IHEX and SREC formats 


6 


If you specify the Intel Hex format or the Motorola S-records format, you 
can use the argument addr_size to specify the size of addresses in bytes 
(record length). For Intel Hex you can use the values: 1, 2, and 4 
(default). For Motorola S-records you can specify: 2 (S1 records), 3 (S2 
records, default) or 4 bytes (S3 records). 


With the argument space_name you can specify the name of the address 
space. The name of the output file will be filename with the extension 
.hex or . sre and contains the code and data allocated in the specified 
space. The other address spaces are also emitted whereas there output 
files are named filename _spacename with the extension .hex or .sre. 


If you do not specify space name, or you specify a non—existing space, 
the default address space is filed in. 


Use option —c (—-chip-output) to create Intel Hex or Motorola S-record 


output files for each chip (suitable for loading into a PROM-programmer). 


Example 


To create the output file myfile.hex of the address space named 
linear: 


ltc test.o -omyfile.hex:IHEX:2,linear 
ltc test.o —-output-myfile.hex:IHEX:2,linear 


Related information 


db 


Linker option —c (Generate an output file for each chip) 
Section 7.1, ELF/DWARF Object Format, in Chapter Object File Formats. 
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-r (—incremental) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 
3. Add the option -r in the Additional options field. 
Command line syntax 


-r 
--incremental 


Description 


Normally the linker links and locates the specified object files. With this 
option you tell the linker only to link the specified files. The linker creates 
a linker output file . out. You then can link this file again with other 
object files until you have reached the final linker output file that is ready 
for locating. 


In the last pass, you call the linker without this option with the final linker 
output file . out. The linker will now locate the file. 


Example 


In this example, the files testl.o, test2.o and test3.o are 
incrementally linked: 


1. ltc -r testl.o test2.o -otest.out 

test1.o and test2.o are linked 
2. ltc --incremental test3.o test.out 

test3 .o is linked together with test .out. File task1 .out is created. 
3. ltc taskl.out (task1.out is located) 


Related information 


Section 7.5, Incremental Linking, in Chapter Using the Linker of the User’s 
Manual. 
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-S (—-strip-debug) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 
3. Enable the options to include that information in the map file. 
4. Disable the option Include symbolic debug information. 
Command line syntax 
-S 
—-strip-debug 


Description 


With this option you specify not to include symbolic debug information in 
the resulting output file. 


Example 
ltc -S test.o -otest.elf 
ltc --strip-debug test.o --output-test.elf 


The linker generates the object file test.elf without symbolic debug 
information. 
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-V (--version) 


EDE 


Command line syntax 
-V 


Description 
Display version information. The linker ignores all other options or input 
files. 
Example 
ltc -V 


ltc --version 


The linker does not link any files but displays the following version 
information: 


TASKING TriCore VX-toolset object linker vx.yrz Build 000 
Copyright years Altium BV Serial# 00000000 


Related information 


d - 
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-v (--verbose) 


EDE 


1. From the Project menu, select Project Options... 
The Project Options dialog appears. 
2. Expand the Linker entry and select Miscellaneous. 


3. Enable the option Print the name of each file as it is processed. 


Command line syntax 


—v[v] 
--verbose 
--extra—verbose 


Description 


With this option you put the linker in verbose mode. The linker prints the 
link phases while it processes the files. In the extra verbose mode, the 
linker also prints the filenames and it shows which objects are extracted 
from libraries. With this option you can monitor the current status of the 
linker. 


Example 
ltc test.o -dextmem.lsl -ddefault.lsl -lc -lfp -lrt -v 


The linker links the file test. o and displays the steps it performs. 


ltc 1437: reading file "extmem.lsl” 

ltc I437: reading file "default.lsl” 

ltc I400: activating link phase 

ltc I403: resolving symbols (taskl) 

ltc I404: generating callgraphs (taskl) 

ltc I408: executing linker commands (taskl) 
ltc I418: finalize linking (taskl) 

ltc I401: activating locate phase 


ltc I432: finalize locating (taskl) 

ltc I402: activating file producing phase 
ltc I433: emitting object files (taskl) 
ltc I434: emitting report files (taskl) 


Related information 


J- 
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-w (—-no-warnings) 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Warnings. 


3. Enable one of the options Report all warnings, Suppress all 
warnings, or Suppress specific warnings. 


If you select Suppress specific warnings: 


4. Enter the numbers, separated by commas, of the warnings you want to 
suppress. 


Command line syntax 
—w[m17|,117]...] 
--no-warnings[—77[,717]...] 
Description 
With this option you can suppresses all warning messages or specific 
warning messages. 
e If you do not specify this option, all warnings are reported. 


e If you specify this option but without numbers, all warnings are 
suppressed. 


e If you specify this option with a number, only the specified warnings 
are suppressed. Separate multiple warnings by commas. 


Example 
To suppress all warnings: 


ltc -w test.o 
ltc --no-warnings test.o 


To suppress warnings 113 and 114: 


ltc -wl13,114 test.o 
ltc --no-warnings=113,114 test.o 
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Related information 


d> Linker option --warnings-as-errors (Treat warnings as errors) 
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—-warnings-as-errors 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Linker entry and select Warnings. 


3. Enable the option Treat warnings as errors. 


Command line syntax 


—-warnings-as-errors 


Description 


With this option you tell the linker to treat warnings as errors. 


Example 


ltc --warnings-as-errors test.o 


When a warning occurs, the linker considers it as an error. 


Related information 


d> Linker option -w (Suppress some or all warnings) 


Tool Options - Control Program 


5.4_ CONTROL PROGRAM OPTIONS 


B 


The control program cctc facilitates the invocation of the various 
components of the TriCore toolchain from a single command line. The 
control program is a command line tool so there are no equivalent options 
in EDE. 


For the linker options in EDE, EDE invokes the linker via the control 
program. Therefore, it uses the syntax of the control program to pass 
options and files to the linker. See section 5.3, Linker Options, for an 
overview of the EDE linker options and the corresponding command line 
linker options. 


Some options are interpreted by the control program itself, other options 
are passed to those programs in the toolchain that accept the option. 


Recognized input files 


The control program recognizes the following input files: 


e Files with a .cc, .cxx or .cpp suffix are interpreted as C++ source 
programs and are passed to the C++ compiler. 


e Files with a .c suffix are interpreted as C source programs and are 
passed to the compiler. 


e Files with a .asm suffix are interpreted as hand-written assembly 
source files which have to be passed to the assembler. 


e Files with a .src suffix are interpreted as compiled assembly source 
files. They are directly passed to the assembler. 


e Files with a .a or .elb suffix are interpreted as library files and are 
passed to the linker. 


e Files with a .o suffix are interpreted as object files and are passed to 
the linker. 


e Files with a .out suffix are interpreted as linked object files and are 
passed to the locating phase of the linker. The linker accepts only one 
.out file in the invocation. 


e An argument with a .1s1 suffix is interpreted as a linker script file and 
is passed to the linker. 


Normally, the control program tries to compile, assemble, link and locate 
all source files to absolute object files. There are however, options to 
suppress the assembler, link or locate stage. 
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-? (--help) 


Command line syntax 


-?[options| 
—-help[-options|] 


Description 


Displays an overview of all command line options. When you specify the 
suboption options, you receive extended information. 


Example 
The following invocations all display a list of the available command line 
options: 
cctc -? 
cctc 


Related information 


de - 
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——address-size 


Command line syntax 


—-address-size—addr_size 


Description 


If you specify IHEX or SREC with the control option —-format, you can 
additionally specify the record length and the address space to be emitted 
in the output files. 


With this option you can specify the size of addresses in bytes (record 
length). For Intel Hex you can use the values: 1, 2, and 4 (default). For 
Motorola S-records you can specify: 2 (S1 records), 3 (S2 records, default) 
or 4 bytes (S3 records). 


If you do not specify addr_size, the default address size is generated. 


Example 
To create the SREC file test. s with S1 records, type: 
cctc —-format-SREC —-address-size-2 
Related information 


Control program option —-format (Set linker output format) 
Control program option —-space (Set linker output space name) 


Linker option —o (Specify an output object file) 
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— 
-C (--cpu) 


Command line syntax 
—Ccpu 


Description 
With this option you define the target processor for which you create your 
application. 


Based on the specified target processor it is automatically detected 
whether a MMU or FPU-unit is present and whether the architecture is a 
TriCore2. This means you do not have to specify the assembler options 
—-mmu-present, —fpu-present and —-is-tricore2 explicitly when one 
of the supported derivatives is selected. 


Based on the specified target processor the control program always 
includes the correct register files, unless you specify control program 
option —-no-tasking-—sfr. 


Example 
To generate the file test.elf for the TC111IB processor: 


cctc -Ctcllib test.c 
cctc --cpu=tcllib test.c 


Related information 
d> Compiler option -C (Use SFR definitions for CPU) 
Assembler option -C (Select CPU) 


Section 5.4, Calling the Compiler, in Chapter Using the Compiler of the 
User’s Manual. 
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—-case-insensitive 


Command line syntax 


—-case-insensitive 


Description 


With this option you tell the control progam not to distinguish between 
upper and lower case characters. By default upper and lower case 
characters are considered as different characters. Note that in assembly 
instruction mnemonics, register names, directives and controls are always 
treated case insensitive. 


Assembly source files that are generated by the compiler must always be 

assembled and linked case sensitive. When you are writing your own 

assembly code, you may want to specify the case insensitive mode. 
Example 


To create the file test.elf with case insensitive assembling and linking: 


cctc -c test.c 
cctc —-case-insensitive test.c 


The assembler and linker now consider upper and lower case characters 
as being the same. So, for example, the label LabelName is the same label 
as labelname. 


Related information 


Assembler option —-case-sensitive (Assemble case insensitive) 
Linker option —-case-sensitive (Link case insensitive) 
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= 
-cc/-cs/-co/-cl 


Command line syntax 
=CC 


—-create=c 


—cs 
—-create-assembly 


—co 
—-create-object 


-cl 


--create=relocatable 


Description 
Normally the control program generates an absolute object file of the 
specified output format from the file you supplied as input. 


With this option you tell the control program to stop after a certain 
number of phases. 


-cc Stop after C++ files are compiled to intermediate C files (. ic) 
-cs Stop after C files are compiled to assembly (. src) 

-co Stop after the files are assembled to object files (. obj) 

-cl Stop after the files are linked to a linker object file (.eln) 


To generate the object file test.o: 


cctc -c test.c 
cctc —-create-object test.c 


The control program stops after the file is assembled. It does not link nor 
locate the generated output. 


Related information 


J- 
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—--check 


Command line syntax 
—-check 


Description 


With this option you can check the source code for syntax errors, without 
generating code. This saves time in developing your application. 


The compiler/assembler reports any warnings and/or errors. 


Example 
To check for syntax errors, without generating code: 
cctc —-check test.c 
Related information 
d> Compiler option --check (Check syntax) 


Assembler option --check (Check syntax) 
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-D (—-define) 


Command line syntax 


-Dmacro_name|zmacro_ definition] 


—-definezmacro_name|zmacro_ definition] 


Description 


With this option you can define a macro and specify it to the preprocessor. 
If you only specify a macro name (no macro definition), the macro 
expands as '1l'. 


You can specify as many macros as you like. On the command line, use 
the option -D multiple times. If the command line exceeds the length limit 
of the operating system, you can define the macros in an option file which 
you then must specify to the control program with the option -f file. 


Defining macros with this option (instead of in the C source) is, for 
example, useful to compile or assemble conditional source as shown in 
the example below. 


The control program passes the option -D (—-define) to the compiler and 
the assembler. 


Example 


Consider the following C program with conditional code to compile a 
demo program and a real program: 


void main( void ) 
{ 
#if DEMO == 1 

demo func(); /* compile for the demo program */ 
#else 

real func(); /* compile for the real program */ 
#endif 
} 


You can now use a macro definition to set the DEMO flag. With the 
control program this looks as follows: 


cctc -DDEMO test.c 
cctc -DDEMO-1 test.c 
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cctc —-define-DEMO test.c 
cctc —-define=DEMO=1 test.c 


Note that all four invocations have the same effect. 


The next example shows how to define a macro with arguments. Note that 
the macro name and definition are placed between double guotes because 
otherwise the spaces would indicate a new option. 


cctc -D”MAX(A,B)-((A) > (B) ? (A): (B))” 
cctc --define="MAX(A,B)=((A) > (B) ? (A) : (B))” 


Related information 


d> Control program option -U (Undefine preprocessor macro) 
Control program option -f (Read options from file) 
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— 
-d (—-lsl-file) 


Command line syntax 
-dfile 
—-lsl-file—fi/e 


Description 
A linker script file contains vital information about the core for the locating 


phase of the linker. A linker script file is coded in LSL and contains the 
following types of information: 


e the architecture and derivative definition describe the core’s hardware 
architecture and its internal memory. 

e the board specification describes the physical memory available in the 
system. 

e the section layout definition describes how to locate sections in 
memory. 


With this option you specify a linker script file via the control program to 
the linker. If you do not specify this option, the linker does not use a 
script file. You can specify the existing file tctarget.ls1 or the name of 
a manually written linker script file. You can use this option multiple 
times. The linker processes the LSL files in the order in which they appear 
on the command line. 


Example 
To read linker script file information from file mylslfile.1s1: 


cctc -dmylslfile.lsl test.obj 
cctc --lsl-file=mylslfile.1lsl test.obj 


Related information 


d> Section 7.7, Controlling the Linker with a Script, in the User's Manual. 
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—-diag 


Command line syntax 
—-diag—[format:|iall | nr,...] 


Description 


With this option you can ask for an extended description of error 
messages in the format you choose. The output is directed to stdout 
(normally your screen) and in the format you specify. You can specify the 
following formats: html, rtf or text (default). To create a file with the 
descriptions, you must redirect the output. 


With the suboption all, the descriptions of all error messages are given. If 
you want the description of one or more selected error messages, you can 
specify the error message numbers, separated by commas. 


With this option the control program does not process any files. 
Example 
To display an explanation of message number 103 , enter: 
cctc —-diag-103 
This results in message 103 with explanation. 


To write an explanation of all errors and warnings in HTML format to file 
ccerrors.html, enter: 


cctc —-diag-html:all > ccerrors.html 


Related information 


J- 
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- 


-E (—-preprocess) 


Command line syntax 
-E[flags] 
—-preprocess-|[//aes] 
You can set the following flags: 


c/C (+/-comments) Keep comments 
p/P (H/-noline) Strip #line source position info 


Description 
With this option you tell the control program to preprocess the C source. 


The compiler sends the preprocessed file to stdout. To capture the 
information in a file, specify an output file with the option -o. 


With -Ec you tell the preprocessor to keep the comments from the C 
source file in the preprocessed output. 


With -Ep you tell the preprocessor to strip the Aline source position 
information (lines starting with #line). These lines are normally 
processed by the assembler and not needed in the preprocessed output. 
When you leave these lines out, the output is more orderly to read. 


Example 


cctc -ECP test.c -o test.pre 
cctc --preprocess +comments,-noline test.c 
—-output-test.pre 


The compiler preprocesses the file test.c and sends the output to the 
file test. pre. Comments are included but the line source position 
information is not stripped from the output file. 


Related information 


d> - 
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—-error-file 


Command line syntax 


—-error-file 


Description 


With this option the control program tells the compiler, assembler and 
linker to redirect error messages to a file. The error file will be named after 
the input file with extension . err (compiler errors), .ers (assembler 
errors) or .e1k (linker errors). 


Example 


To write errors to error files instead of stderr, enter: 


cctc —-error-file -t test.c 


Related information 


d> Control program option —-—-warnings-as-errors (Warnings as errors) 
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—-exceptions 


Command line syntax 


—-exceptions 


Description 


With this option you enable support for exception handling in the C++ 
compiler. 


Example 


To enable exception handling, enter: 


cctc —-exceptions test.cc 


Related information 


d> - 
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-F (—no-double) 


Command line syntax 
-F 
—-no-double 

Description 


With this option you tell the control program to treat variables of the type 
double as float. Because the float type takes less space, execution speed 
increases and code size decreases, both at the cost of less precision. 


Example 


cctc -F test.c 
cctc —mno-double test.c 


The file test.c is processed where variables of the type double are 
treated as float in the compilation phase. 


Related information 


d> Control program option --use-double-precision-fp (Do not replace 
doubles with floats) 
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-f (—option-file) 


Command line syntax 


-f file 


--option-file=/ile 


Description 


Instead of typing all options on the command line, you can create a option 
file which contains all options and file you want to specify. With this 
option you specify the option file to the control program. 


Use an option file when the length of the command line would exceed the 
limits of the operating system, or just to store options and save typing. 


You can specify the option -f multiple times. 


Format of an option file 


Multiple command line arguments on one line in the option file are 
allowed. 


To include whitespace in an argument, surround the argument with 
single or double guotes. 


If you want to use single guotes as part of the argument, surround the 
argument by double guotes and vise versa: 


"This has a single quote ' embedded” 
'This has a double guote ” embedded' 


‘This has a double quote ” and \ 
a single quote '”' embedded” 


Note that adjacent strings are concatenated. 


When a text line reaches its length limit, use a ’\’ to continue the line. 
Whitespace between quotes is preserved. 


"This is a continuation \ 
line” 
-> "This is a continuation line” 


It is possible to nest command line files up to 25 levels. 
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Example 
Suppose the file myoptions contains the following lines: 
-g 
-k 
test.c 


Specify the option file to the control program: 


ctc -f myoptions 
ctc --option-file=myoptions 


This is equivalent to the following command line: 


ctc -g -k test.c 


Related information 


J- 
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—-force-c 


Command line syntax 


—-force-c 


Description 


With this option you tell the control program to treat all . cc files as C files 
instead of C++ files. This means that the control program does not call the 
C++ compiler and forces the linker to link C libraries. 


Example 


cctc --force-c test.cc 


The C++ file test.cc is considered to be a normal C file. 


Related information 


d> Control program option --force-c++ (Force C++ compilation and linking) 
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—-—force-c++ 


—-force-c++ 


Description 


With this option you tell the control program to treat all .c files as C++ 
files instead of C files. This means that the control program calls the C++ 


compiler prior to the C compiler and forces the linker to link C++ libraries. 


Example 


cctc —-force-crr test.c 
The file test.c is considered to be a C++ file. 


Related information 


d> Control program option —-force-c (Treat C++ files as C files) 
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—-force-munch 


Command line syntax 


--force-munch 


Description 


With this option you force the control program to activate the muncher in 
the pre-locate phase. 


Example 


To force the muncher phase in the pre-locate phase, type: 


cctc —-force-rmunch test.cc 


Related information 


d> - 
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—-force-prelink 


Command line syntax 
—-force-prelink 


Description 


With this option you force the control program to invoke the C++ 
pre-linker. 


Example 


cctc —-force-prelink test.cc 


The control program always invokes the C++ pre-linker when generating 
test.elf. 


Related information 


de - 
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—-format 


Command line syntax 


—-format—format 
You can specify the following formats: 


ELF ELF/DWARF 

IEEE IEEE-695 

IHEX Intel Hex 

SREC Motorola S—records 
Description 


With this option you specify the output format for the resulting (absolute) 
object file. The default output format is ELF/DWARF, which can directly be 
used by the CrossView Pro debugger. 


If you choose IHEX or SREC, you can additionally specify the address size 
of the chosen format (option ——address-size) and the address space to 
be emitted (option —-space). 


Example 
To generate an IEEE output file: 
cctc —-format-IEEE testl.c test2.c —--output-test.abs 
Related information 


d> Control program option —-address-size (For linker IHEX./SREC files) 
Control program option —-space (Set linker output space name) 


Linker option —o (output file) 
Linker option -C (generate hex file) 


Section 7.1, ELF/DWARF Object Format, in Chapter Object File Formats. 
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—-fp-trap 


Command line syntax 
—-fp-trap 


Description 


Default the control program uses the non-trapping floating-point library 
(libfp.a). With this option you tell the control program to use the 
trapping floating-point library (1ibfpt.a). 


If you use the trapping floating-point library, exceptional floating-point 
cases are intercepted and can be handled separately by an application 
defined exception handler. Using this library decreases the execution 
speed of your application. 
Example 
cctc —-fp-trap test.c 


Link the trapping floating-point library when generating the object file 
test.elf. 


Related information 


â - 
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—-fpu-present 


Command line syntax 


—-fpu-present 


Description 


With this option the compiler can generate single precision floating-point 
instructions in the assembly file. When you select this option, the macro 
__ FPU___ is defined in the C source file. 


This option automatically sets the option --no-double, which treats 
‘double’ as ’float’, unless you overrule it with option 
--use-double-precision-fp. 


& If you choose a valid target processor (command line option -C (—-cpu)), 
this option is automatically set, based on the chosen target processor. 


Example 


To allow the use of floating-point unit (FPU) instructions in the assembly 
code and treat 'double' as 'floav, enter: 


ctc —-fpu-present test.c 


Related information 


d> Control program option —-use-double-precision-fp (Do not replace 
doubles with floats) 


Compiler option -C (Use SFR definitions for CPU) 
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-g (--debug-info) 


Command line syntax 
-8 
—-debug-info 


Description 


With this option you tell the control program to include debug information 
in the generated object file. 


Example 


cctc -g test.c 
cctc —-debug-info test.c 


The control program includes symbolic debug information in the 
generated object file test.elf. 


Related information 
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-I (—include-directory) 


Command line syntax 
-Ipath 


—-include-directory=path 


Description 
With this option you can specify the path where your include files are 
located. A relative path will be relative to the current directory. 
Example 


Suppose that the C source file test.c contains the following lines: 


#include <stdio.h> 
#include "myinc.h” 


You can call the control program as follows: 


cctc -Imyinclude test.c 
cctc —-include-directory-myinclude 


First the compiler looks for the file stdio.h in the directory myinclude 
relative to the current directory. If it was not found, the compiler searches 
in the environment variable and then in the default include directory. 


The compiler now looks for the file myinc.h in the directory where 
test.c is located. If the file is not there the compiler searches in the 
directory myinclude. If it was still not found, the compiler searches in the 
environment variable and then in the default include directory. 


Related information 


d> Compiler option -I (Add directory to include file search path) 
Compiler option -H (Include file at the start of a compilation) 
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—-instantiate 


Command line syntax 


—-instantiate—ode 


Description 


Normally, when a file is compiled, no template entities are instantiated 
(except those assigned to the file by automatic instantiation). The overall 
instantiation mode can, however, be changed with this option. You can 
specify the following modes: 


none 


used 


all 


local 


Do not automatically create instantiations of any template 
entities. This is the default. It is also the usually appropriate 
mode when automatic instantiation is done. 


Instantiate those template entities that were used in the 
compilation. This will include all static data members for which 
there are template definitions. 


Instantiate all template entities declared or referenced in the 
compilation unit. For each fully instantiated template class, all of 
its member functions and static data members will be 
instantiated whether or not they were used. Non-member 
template functions will be instantiated even if the only reference 
was a declaration. 


Similar to --instantiate=used except that the functions are 
given internal linkage. This is intended to provide a very simple 
mechanism for those getting started with templates. The 
compiler will instantiate the functions that are used in each 
compilation unit as local functions, and the program will link 
and run correctly (barring problems due to multiple copies of 
local static variables). However, one may end up with many 
copies of the instantiated functions, so this is not suitable for 
production use. 


You cannot use --instantiate=local in conjunction with automatic 
template instantiation. 


Example 


To specify instantiation mode used, type 


cctc 


--instantiate=used test.cc 
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Related information 


J- 
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—-instantiation-dir 


Command line syntax 


—-instantiation-dir=dir 


Description 


With this option the C++ compiler generates additional files for template 
instantiations in the specified directory. 


If you do not specify this option, files are created in the current directory. 


& If you specify the control program option 
—-no-one-instantiation-per-object, this option remains without effect. 


Example 


To specify the directory for instantiation files, type 


cctc —-instantiation-dir-instant test.cc 


Related information 


d> Control program option —-no-one-instantiation-per-object 
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—-instantiation-file 


Command line syntax 


—-instantiation-file—///e 


Description 


With this option the C++ compiler generates a list of all generated template 
instantiation files and writes it to the specified file. You can use this file for 
example to use as an option file for the archiver artc. 


Example 


To create a file with a list of all generated instantiation files, type 


cctc —-instantiation-file-instlist.ii test.cc 


Related information 


J- 
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—-is-tricore2 


Command line syntax 


—-is-tricore2 


Description 


With this option you allow the control program to use TriCore 2 
instructions in the generated output file. 


& If you choose a valid target processor (command line option -C (—-cpu)), 
this option is automatically set, based on the chosen target processor. 


Example 
To allow the use of TriCore 2 instructions in the assembly code, enter: 
cctc —-is-tricore2 test.c 
Related information 


d> Compiler option -C (Use SFR definitions for CPU) 
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—-ISO 
Command line syntax 


—-iso—(90 | 99) 


Description 


With this option you specify to the control program against which ISO 
standard it should check your C source. C90 is also referred to as the 
"ANSI C standard”. C99 refers to the newer ISO/IEC 9899:1999 (E) standard 
and is the default. 


& Independent of the chosen ISO standard, the control program always links 
libraries with C99 support. 


Example 


To compile the file test.c conform the ISO C90 standard: 


cctc —-iso-90 test.c 


Related information 


d> Compiler option -c (ISO C standard) 
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-k (—keep-output-files) 


Command line syntax 
-k 


—-keep-output-files 


Description 


If an error occurs during the compilation, assembling or linking process, 
the resulting output file may be incomplete or incorrect. With this option 
you keep the generated output files when an error occurs. 


By default the control program removes generated output files when an 
error occurs. This is useful when you use the make utility. If the erroneous 
files are not removed, the make utility may process corrupt files on a 
subseguent invocation. 


Use this option when you still want to use the generated files. For 
example when you know that a particular error does not result in a 
corrupt file, or when you want to inspect the output file, or send it to 
Altium support. 


Example 


cctc -k test.c 
cctc —-keep-output-files test.c 


When an error occurs during compiling, assembling or linking, the 
erroneous generated output files will not be removed. 


Related information 


d - 
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-L (—-library-directory / 
—-ignore-default-library-path) 


Command line syntax 
-Lpath 
—-library-directory=path 


-L 
—-ignore-default-library-path 
Description 


With this option you can specify the path(s) where your system libraries, 
specified with the -1 option, are located. If you want to specify multiple 
paths, use the option -L for each separate path. 


The default path is $(PRODDIR) \lib\tcl. 


If you specify only -L (without a pathname) or the long option 
—-ignore-default-library-path, the linker will not search the default 
path and also not in the paths specified in the environment variables 
LIBTC1V1_2, LIBTC1V1_3 or LIBTC2. So, the linker ignores steps 2 and 3 
as listed below. 


The priority order in which the linker searches for system libraries 
specified with the -1 option is: 


1. The path that is specified with the -L option. 


2. The path that is specified in the environment variables LIBTC1V1_2, 
LIBTC1V1_3 or LIBTC2 when the product was installed. 


3. The default directory $ (PRODDIR)NMLibXtcl or 
$(PRODDIR)\lib\tc2. 


Example 
Suppose you call the control program as follows: 


cctc test.c -Lc:Amylibs -lcs 
cctc test.c —-library-directory=c:\mylibs -lcs 


First the linker looks in the directory c:Xmylibs for library 1ibc.a (this 
option). 
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If it does not find the reguested libraries, it looks in the directory that is set 
with the environment variables LIBTC1V1_2, LIBTC1V1_3 or LIBTC2. 


Then the linker looks in the default directory $ (PRODDIR)NMLibXtc1 or 
$(PRODDIR) \lib\tc2 for libraries. 


Related information 


d> Linker option -1 (Search also in system library libname) 
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-I (—-library) 


Command line syntax 


-lIname 


—-library=name 


Description 


With this option you tell the linker via the control program to search also 
in system library libname.a, where name is a string. The linker first 
searches for system libraries in any directories specified with -Lpath, then 
in the directories specified with the environment variables LIBTC1V1_2, 
LIBTC1V1_3 or LIBTC2, unless you used the option -L without a directory. 


Example 
To search in the system library libfp.a (floating-point library): 


cctc test.obj mylib.a -lfp 
cctc test.obj mylib.a --library=fp 


The linker links the file test. obj and first looks in mylib.a (in the 
current directory only), then in the system library libfp.a to resolve 
unresolved symbols. 


Related information 


d> Control program option -L (Add library directory) 


Section 7.4, Linking with Libraries, in the User's Manual. 
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—-list-object-files 


Command line syntax 
—-list-object-files 


Description 


With this option the list of object files that are handled by the prelinker, is 
displayed at stdout. The list is shown when it is changed by the 
prelinker. 


Example 
To show the list of object files handled by the prelinker, enter: 


cctc —-list-object-files test.cc 


Related information 


d - 
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—-mmu-present 


Command line syntax 


--mmu-present 


Description 


With this option you can use memory management instructions in the 
assembly code. When you select this option, the define _ MMU _ is set 
tol. 


Example 


To allow the use of memory management unit (MMU) instructions in the 
assembly code, enter: 


cctc —mmmu-present test.c 


Related information 
d> Assembler option -C (Select CPU) 
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-n (—-dry-run) 


Command line syntax 
-n 
—-dry-run 
Description 


With this option you put the control program verbose mode. The control 
program prints the invocations of the tools it would use to process the 
files. 


Example 


To see how the control program will invoke the tools it needs to process 
the file test.c: 


cctc -n test.c 
cctc —-dry-run test.c 


The control program only displays the invocations of the tools it would 
use to create the final object file but does not actually perform the steps. 


Related information 


d> Control program option —v (Verbose output) 
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—-no-auto-instantiation 


Command line syntax 


—-no-auto-instantiation 


Description 


Default, the c++ compiler automatically instantiates templates. With this 
option automatic instantiation of templates is disabled. 


Example 
To disable automatic instantiation, type 


cctc --no-auto-instantiation test.cc 


Related information 


d> For an extensive description of automatic insantiation, refer to section 
2.6.1, Automatic Instantiation, in the TriCore C++ Compiler User's Manual. 
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——no-default-libraries 


Command line syntax 


—--no-default-libraries 


Description 


Default the control program specifies the standard C libraries and run-time 
library to the linker. 


With this option you tell the control program not to specify the standard C 
libraries and run-time library to the linker. 


In this case you must specify the libraries you want to link to the linker 
with the option —-Wibrary_name. The control program recognizes the 
option -l as an option for the linker. 


Example 
cctc --no-default-libraries test.c 


The control program does not specify any libraries to the linker. In normal 
cases this would result in unresoved externals. 


To specify your own libraries (Libmy. a) and avoid unresolved externals: 
cctc --no-default-libraries -lmy test.c 


Related information 


d> Linker option -1 (Search also in system library libx.a) 
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— 
--no-map-file 


Command line syntax 


--no-map-file 
Description 
By default the control program generates a linker map file (.map). 


A linker map file is a text file that shows how the linker has mapped the 
sections and symbols from the various object files (. obj) to the linked 
object file. A locate part shows the absolute position of each section. 
External symbols are listed per space with their absolute address, both 
sorted on symbol and sorted on address. 


With this option you prevent the generation of a map file. 
Example 
To prevent the generation of the linker map file test .map: 


cctc --no-map-file test.c 


Related information 
d> Linker option -M (Generate map file) 
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—-no-one-instantiation-per-object 


Command line syntax 


—-no-one-instantiation-per—-object 


Description 


With this option, the C++ compiler writes template instantiations into a 
single object file. If you do not specify this option, the C++ compiler 
creates multiple files. In that case you can specify a directory for those files 
with the control program option —-instantiation-dir. 


Example 


To create a file with a list of all generated instantiation files, type 


cctc —-no-one-instantiation-per-object test.cc 


Related information 


d> Control program option —-instantiation-dir 
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—-no-tasking-sfr 


Command line syntax 


—-no-tasking—sfr 


Description 


Normally, the compiler and assembler include a special function register 
(SFR) file before compiling. This file is automatically selected based on the 
target you select on the Processor definition page of the Processor 
options (compiler option -C). 


With this option the compiler and assembler do not automatically include 
a register file. 


Use this option if you want to use your own set of SFR files. 
Example 
cctc -Ctcllib --no-tasking-sfr test.c 


The register file regtcllib.sfr is not included. 


Related information 
d> Compiler option -C (Use SFR definitions for CPU) 
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-o (--output) 
Command line syntax 
—ofile 
—-output-fi/e 


Description 


By default, the control program generates a file with the same basename 
as the first specified input file. With this option you specify another name 
for the resulting absolute object file. 


Example 


cctc test.c prog.c 


The control program generates an ELF/DWARF object file (default) with 
the name test.elf. 


To generate the file result.elf: 


cctc -oresult.elf test.c prog.c 
cctc —-output-rresult.elf test.c prog.c 


Related information 


f- 
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— 
—-prelink-copy-if-non-local 


Command line syntax 
—-prelink-copy-if-non-local 


Description 


If a file must be recompiled and it is not in the current directory, with this 
option the C++ prelinker copies the prelink file (. ii) to the current 
directory and rewrites that .ii file so it can find its associated .cc file. As a 
result, the .cc file is recompiled in the current directory. 


With this option you prevent that previously compiled files are overwritten 
during recompilation. 


Example 


To copy all files for recompilation to the current directory: 


cctc —-prelink-copy-if-non-local test.cc 


Related information 


J- 
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—-prelink-local-only 


Command line syntax 
—-prelink-local-only 


Description 


With this option the C++ prelinker ignores all files that are outside the 
current directory. 


Example 


To prelink only files in the current directory: 


cctc —-prelink-local-only test.cc 


Related information 


de - 
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—-prelink-remove-instantiation-flags 


Command line syntax 


—-prelink-remove-instantiation-flags 


Description 


With this option the C++ prelinker removes all instantiation flags from the 
generated object files. 


Example 


To remove instantiation flags from the generated object files: 


cctc —-prelink-remove-instantiation-flags test.cc 


Related information 


d> - 
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--show-c++-warnings 


Command line syntax 


--show-c++-warnings 


Description 


The C++ compiler may generate a compiled C++ file (. ic) that causes 
warnings during compilation or assembling. With this option you tell the 
control program to show these warnings. Default C++ warnings are 
suppressed. 


Example 
cctc --show-ct++-warnings test.cc 


The control program calls the C++ compiler which generates the C file 
(test.ic). If this file causes warnings during compilation or assembling, 
these warnings are shown. 


Related information 


J- 
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—-silicon-bug 


EDE 


1. From the Project menu, select Project Options... 
Tbe Project Options dialog appears. 
2. Expand the Processor entry and select Bypasses. 
3. Select the bypasses you want to enable. 
Command line syntax 
—-silicon-bug—drg,... 


For a list of available arguments refer to the description of option 
—-silicon-bug of the compiler and assembler. Depending on the available 
arguments this option is passed to the compiler and/or assembler. 


Description 


With this option the control program tells the compiler/assembler/linker to 
use software workarounds for some CPU functional problems. 


Example 
cctc —-silicon-bug-cpu-tc021,cpu-tc030 test.c 


The compiler uses workarounds for problems CPU_TC.024 and 
CPU_TC.030. 


Related information 


d> See Chapter 9, CPU Functional Problems, for more information about the 


individual problems and workarounds. 


Assembler option —-silicon-bug 
Compiler option —-silicon-bug 
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--space 


Command line syntax 


—-space-space name 


Description 


If you specify IHEX or SREC with the control option —-format, you can 
additionally specify the record length and the address space to be emitted 
in the output files. 


With this option you can specify which address space must be emitted. 
With the argument space_name you can specify the name of the address 
space. The name of the output file will be filename with the extension 
.hex or .s. 


If you do not specify space name, the default address space is emitted. In 
this case the name of the output file will be filename _spacename with the 
extension .hex or .s. 


Example 
To create the IHEX file test.hex, type: 
cctc —-format-IHEX --space=far test.c 


If the specified memory space does not exist, the control program emits 
the default space name and reflects this in the output file name. 


Related information 
d> Control program option —-format (Set linker output format) 


Linker option —o (Specify an output object file) 
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—-static 


Command line syntax 


—-—static 


Description 
This option is directly passed to the compiler. 
With this option, the compiler treats external definitions at file scope 
(except for main) as if they were declared static. As a result, unused 
functions will be eliminated, and the alias checking algorithm assumes that 


objects with static storage cannot be referenced from functions outside the 
current module. 


This option only makes sense when you specify all modules of an 
application on the command line. 


Example 


cctc —-static modulel.c module2.c module3.c 


Related information 


d> - 
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-t (--keep-temporary-files) 


Command line syntax 
-t 


—-keep-temporary-files 


Description 


By default, the control program removes intermediate files like the . src 
file (result of the compiler phase) and the . eln file (result of the linking 
phase). 


With this option you tell the control program to keep temporary files it 
generates during the creation of the absolute object file. 


Example 
To keep all temporary files: 


cctc -t test.c 
cctc —-keep-temporary-files test.c 


The control program keeps all intermediate files it generates while creating 
the absolute object file test.elf. 


Related information 


də- 
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— 
-U (--undefine) 


Command line syntax 


-Umacro_name 
--undefine=macro_name 


Description 


With this option you can undefine an earlier defined macro as with 
#undef. 


This option is for example useful to undefine predefined macros. 


However, the following predefined ISO C standard macros cannot be 


undefined: 
_ FILE __ current source filename 
_ LINE_ current source line number (int type) 


_ TIME hh:mm:ss 
_ DATE mmm dd yyyy 
_ SIDC _ level of ANSI standard 


The control program passes the option -U (--undefine) to the compiler. 


Example 
To undefine the predefined macro _ TASKING __: 


cctc -U_ TASKING test.c 
cctc --undefine=_ TASKING _ test.c 


Related information 


d> Control Pogram option -D (Define preprocessor macro) 
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—-use-double-precision-fp 


Command line syntax 


—-use-double-precision-fp 


Description 


When an FPU is present the control program will by default compile all 
doubles as floats to make full use of the FPU. When you do not want this, 
use the option --use-double-precision-fp. 


Example 


To allow the use of floating-point unit (FPU) instructions in the assembly 
code and treat 'double' as 'double', enter: 


ctc --fpu-present —-use-double-precision-fp test.c 


Related information 


d> Control program option —-fpu—present (Use hardware floating-point 
instructions) 
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-V (--version) 


Command line syntax 
-V 
—-version 
Description 


Display version information. The control program ignores all other options 
or input files. 


Example 


cctc -V 
cctc —-version 


The control program does not call any tools but displays the following 
version information: 


TASKING TriCore VX-toolset control program vx.yrz Build nnn 
Copyright 2003-year Altium BV Serial 00000000 


Related information 


d> - 
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-v (--verbose) 


Command line syntax 
-vV 
—-verbose 
Description 


With this option you put the control program in verbose mode. With the 
option —v the control program performs it tasks while it prints the steps it 
performs to stdout. 


Example 


cctc -v test.c 
cctc —-verbose test.c 


The control program processes the file test.c and displays the 
invocations of the tools it uses to create the final object file 


Related information 


d> Control program option -n (Verbose output and suppress execution) 


5-209 


5-210 TriCore Reference Manual 


- 


-Wtool (—-pass) 


Command line syntax 


-Wcpoption -—pass-c++=option Pass option directly to the 
C++ compiler 

-Weoplion _ —-—pass-c=option Pass option directly to the 
C compiler 

—Waoption —-pass-assembler=option Pass option directly to the 
assembler 

-Wploption --pass-prelinker=opiion Pass option directly to the 
C++ prelinker 

—Wloption —-pass-linker>oprion Pass option directly to the 
linker 

Description 


With this option you tell the control program to call a tool with the 
specified option. The control program does not use the option itself, but 
specifies it directly to the tool which the control program calls. 


Example 


cctc -Wl-r test.c 


The control program does not use the option —r but calls the linker with 
the option -rf (lte -r). 


Related information 


l> - 
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-w (—-no-warnings) 


Command line syntax 


—w[777'| 
--no-warnings[—7'| 


Description 


With this option suppresses all warning messages or a specific warning. If 
you do not specify this option, all warnings are reported. 


Example 
To suppress all warnings: 


cctc -w test.c 
cctc --no-warnings test.c 


To suppress warnings 100: 


cctc -w100 test.c 
cctc —-no-warnings-100 test.c 


Related information 


d> Control program option --warnings-as-errors (Warnings as errors) 
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—-warnings-as-errors 


Command line syntax 


—-warnings-as-errors 


Description 


With this option you tell the control program to treat warnings as errors. 


Example 


cctc —-warnings-as-errors test.c 
When a warning occurs, the control program considers it as an error. 
Related information 


d> Control program option -w (Suppress all warnings) 
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5.5 MAKE UTILITY OPTIONS 


When you build a project in EDE, EDE generates a makefile and uses the 
graphical make utility wmk to build all your files. However, you can also 
use the make utility mktc from the command line to build your project. 


The invocation syntax is: 
mktc [option...] [target...] [macro-def] 


This section describes all options for the make utility. The make utility is a 
command line tool so there are no eguivalent options in EDE. 
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Defining Macros 


Command line syntax 


macro=definition 


Description 


With this argument you can define a macro and specify it to the make 
utility. 


A macro definition remains in existence during the execution of the 
makefile, even when the makefile recursively calls the make utility again. 
In the recursive call, the macro acts as an environment variable. This 
means that it is overruled by definitions in the recursive call. Use the 
option —e to prevent this. 


You can specify as many macros as you like. If the command line exceeds 
the limit of the operating system, you can define the macros in an option 
file which you then must specify to the compiler with the option -m file. 


Defining macros on the command line is, for example, useful in 
combination with conditional processing as shown in the example below. 


Example 


Consider the following makefile with conditional rules to build a demo 
program and a real program: 


ifdef DEMO # the value of DEMO is of no importance 
real.out : demo.o 
ltc demo.o main.o -lc -lfp -lrt 
else 
real.out : real.o 
ltc real.o main.o -lc -lfp -lrt 
endif 


real.elf : real.out 
ltc -FELF -oreal.elf real.out 


You can now use a macro definition to set the DEMO flag: 
mktc real.elf DEMO=1 


In both cases the absolute obect file real.elf is created but depending 
on the DEMO flag it is linked with demo.o or with real.o. 
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Related information 


Make utility option —e (Environment variables override macro definitions) 
Make utility option -m (Name of invocation file) 
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-_? 


Command line syntax 
-? 


Description 


Displays an overview of all command line options. 


Example 
The following invocation displays a list of the available command line 
options: 
mktc —? 


Related information 


d> - 
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—a 


Command line syntax 


-a 


Description 


Normally the make utility rebuilds only those files that are out of date. 
With this option you tell the make utility to rebuild all files, without 
checking whether they are out of date. 


Example 


mktc -a 


Rebuilds all your files, regardless of whether they are out of date or not. 


Related information 


de - 


5-218 TriCore Reference Manual 


-C 


Command line syntax 


=C 


Description 


EDE uses this option for the graphical version of make when you create 
sub-projects. In this case make calls another instance of make for the 
sub-project. With the option —c, the make utility runs as a child process of 
the current make. 


The option —c overrules the option —err. 


Example 


The following command runs the make utility as a child process: 
mktc —c 


Related information 


d> Make utility option —err (Redirect error message to file) 
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-D/-DD 


Command line syntax 
-D 
-DD 
Description 
With the option -D the make utility prints every line of the makefile to 
standard output as it is read by mktc. 


With the option -DD not only the lines of the makefile are printed but 
also the lines of the mktc .mk file (implicit rules). 


Example 
mktc -D 


Each line of the makefile that is read by the make utility is printed to 
standard output (usually your screen). 


Related information 


J- 
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-d/-dd 


Command line syntax 
-d 
-dd 
Description 


With the option —d the make utility shows which files are out of date and 
thus need to be rebuild. The option -dd gives more detail than the option 
-d. 


Example 
mktc -d 


Shows which files are out of date and rebuilds them. 


Related information 


J- 
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—e 


Command line syntax 


=e 


Description 


If you use macro definitions, they may overrule the settings of the 
environment variables. 


With the option —e, the settings of the environment variables are used 
even if macros define otherwise. 


Example 


mktc -e 


The make utility uses the settings of the environment variables regardless 
of macro definitions. 


Related information 


J- 
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—err 


Command line syntax 


—err file 


Description 


With this option the make utility redirects error messages and verbose 
messages to a specified file. 


With the option —s the make utility only displays error messages. 


Example 


mktc -err error.txt 
The make utility writes messages to the file error. txt. 


Related information 


d> Make utility option -s (Do not print commands before execution) 
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-f 


Command line syntax 
-f my_makefile 


Description 
Default the make utility uses the file makefile to build your files. 


With this option you tell the make utility to use the specified file instead of 
the file makefile. Multiple -f options act as if all the makefiles were 
concatenated in a left-to-right order. 


Example 


mktc mymake 


The make utility uses the file mymake to build your files. 


Related information 


J- 
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Command line syntax 
-G path 


Description 
Normally you must call the make utility mktc from the directory where 
your makefile and other files are stored. 


With the option -G you can call the make utility from within another 
directory. The patb is the path to the directory where your makefile and 
other files are stored and can be absolute or relative to your current 
directory. 


Example 


Suppose your makefile and other files are stored in the directory 
\currdir\myfiles. When your current directory is \currdir, you can 
call the make utility as follows: 


mktc -G myfiles 


Related information 


fJ- 
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Command line syntax 


=i 


Description 


When an error occurs during the make process, the make utility exits with 
a certain exit code. 


With the option —i, the make utility exits without an error code, even 
when errors occurred. 


Example 


mktc -i 


The make utility exits without an error code, even when an error occurs. 


Related information 


J- 
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-K 


Command line syntax 
-K 


Description 


With this option the make utility Keeps temporary files it creates during the 
make process. The make utility stores temporary files in the directory that 
you have specified with the environment variable TMPDIR or in the 
default 'temp' directory of your system when the TMPDIR variable is not 
specified. 
Example 
mktc -K 


The make utility preserves all temporary files. 


Related information 


Section 1.3.2, Configuring the Command Line Environment, in Chapter 
Software Installation of the User’s Manual. 
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-k 


Command line syntax 
-k 


Description 


When during the make process the make utility encounters an error, it 
stops rebuilding your files. 


With the option -k, the make utility only stops building the target that 
produced the error. All other targets defined in the makefile are built. 


Example 
mktc -k 


If the make utility encounters an error, it stops building the current target 
but proceeds with the other targets that are defined in the makefile. 


Related information 
d> Make utility option -S (Undo the effect of -k) 
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Command line syntax 


-m file 


Description 


Instead of typing all options on the command line, you can create an 
option file which contains all options and flags you want to specify. With 
this option you specify the option file to the make utility. 


Use an option file when the length of the command line would exceed the 
limits of the operating system, or just to store options and save typing. 


You can specify the option -m multiple times. 


Format of an option file 


Multiple command line arguments on one line in the option file are 
allowed. 


To include whitespace in an argument, surround the argument with 
single or double quotes. 


If you want to use single quotes as part of the argument, surround the 
argument by double quotes and vise versa: 


"This has a single quote ' embedded” 
'This has a double quote ” embedded' 


‘This has a double quote ” and \ 
a single quote '"”' embedded” 


Note that adjacent strings are concatenated. 


When a text line reaches its length limit, use a ’\’ to continue the line. 
Whitespace between guotes is preserved. 


"This is a continuation \ 
line” 
-> "This is a continuation line” 


It is possible to nest command line files up to 25 levels. 
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Example 
Suppose the file myoptions contains the following lines: 
-=k 
-err errors.txt 
test.elf 
Specify the option file to the make utility: 
mktc -m myoptions 


This is equivalent to the following command line: 


mktc -k -err errors.txt test.elf 


Related information 


f- 
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Command line syntax 


-n 


Description 


With this option you tell the make utility to perform a dry run. The make 
utility shows what it would do but does not actually perform these tasks. 


This option is for example useful to quickly inspect what would happen if 
you call the make utility. 


Example 
mktc -n 


The make utility does not perform any tasks but displays what it would do 
if called without the option —n. 


Related information 


d> Make utility option -s (Do not print commands before execution) 
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Command line syntax 
-P 
Description 


Normally, if a command in a target rule in a makefile returns an error or 
when the target construction is interrupted, the make utility removes that 
target file. With this option you tell the make utility to make all target files 
precious. This means that all dependency files are never removed. 


Example 
mktc -p 


The make utility never removes target dependency files. 


Related information 


Special target .PRECIOUS in section 8.3.2, Writing a Makefile in Chapter 
Using the Utilities of the Reference Manual. 
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Command line syntax 
-q 
Description 


With this option the make utility does not perform any tasks but only 
returns an error code. A zero status indicates that all target files are up to 
date, a non-zero status indicates that some or all target files are out of 
date. 


Example 
mktc -g 


The make utility only returns an error code that indicates whether all target 
files are up to date or not. It does not rebuild any files. 


Related information 


f- 
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-r 


Command line syntax 


-r 


Description 


When you call the make utility, it first reads the implicit rules from the file 
mktc.mk, then it reads the makefile with the rules to build your files. (The 
file mktc .mk is located in the \etc directory of the TriCore toolchain.) 


With this option you tell the make utility not to read mktc .mk and to rely 
fully on the make rules in the makefile. 


Example 


mktc -r 


The make utility does not read the implicit make rules in mktc .mk. 


Related information 


J- 
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-S 


Command line syntax 
-S 


Description 


With this option you cancel the effect of the option -k. This is never 
necessary except in a recursive make where the option -k might be 
inherited from the top-level make via MAKEFLAGS or if you set the option 
=k in the environment variable MAKEFLAGS. 


Example 
mktc -S 


The effect of the option -k is cancelled so the make utility stops with the 
make process after it encounters an error. 


The option -k in this example may have been set with the environment 
variable MAKEFLAGS or in a recursive call to mktc in the makefile. 


Related information 


Make utility option -k (On error, abandon the work for the current target 
only) 
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-S 
Command line syntax 
=S 


Description 
With this option you tell the make utility to perform its tasks without 


printing the commands it executes. Error messages are normally printed. 


Example 


mktc -s 


The make utility rebuilds your files but does not print the commands it 
executes during the make process. 


Related information 


d> Make utility option —n (Perform a dry run) 
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=t 


Command line syntax 
-t 


Description 


With this option you tell the make utility to /oucb the target files, bringing 
them up to date, rather than performing the rules to rebuild them. 


Example 
mktc -t 


The make utility updates out-of-date files by giving them a new date and 
time stamp. The files are not actually rebuild. 


Related information 


J- 
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-time 


Command line syntax 


-time 


Description 


With this option you tell the make utility to display the current date and 
time on standard output. 


Example 


mktc -time 


The make utility displays the current date and time and updates 
out-of-date files. 


Related information 


de - 
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-V 


Command line syntax 
-V 


Description 


Display version information. The make utility ignores all other options or 
input files. 


Example 
mktc -v 


The make utility does not perform any tasks but displays the following 
version information: 


TASKING TriCore VX-toolset program builder vxx.yrz Build nnn 
Copyright year Altium BV Serial# 00000000 


Related information 


de - 
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-W 


Command line syntax 
-W target 


Description 


With this option the make utility considers the specified target file always 
as up to date and will not rebuild it. 


Example 
mktc -W test.elf 


The make utility rebuilds out of date targets in the makefile except the file 
test.elf which is considered now as up to date. 


Related information 


de - 
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Command line syntax 


-W 


Description 


With this option the make utility sends error messages and verbose 
messages to standard out. Without this option, the make utility sends these 
messages to standard error. 


& This option is only useful on UNIX systems. 


Example 


mktc -w 


The make utility sends messages to standard out instead of standard error. 


Related information 


f- 
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-X 


Command line syntax 


-X 


Description 


With this option the make utility shows extended error messages. 
Extended error messages give more detailed information about the exit 
status of the make utility after errors. EDE uses this option for the 
graphical version of make. 


Example 


mktc -x 


If errors occur, the make utility gives extended information. 


Related information 


J- 
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5.6_ ARCHIVER OPTIONS 


The archiver and library maintainer artc is a tool to build library files and 
it offers the possibility to replace, extract and remove modules from an 
existing library. 


The invocation syntax is: 
artc key option [sub option...] library [object file] 


This section describes all options for the archiver. Some suboptions can 
only be used in combination with certain key options. They are described 
together. Suboptions that can always be used are described separately. 


The archiver is a command line tool so there are no eguivalent options in 


EDE. 
Description Option Suboption 
Display an overview of all options -? 
Display version information -V 
Print object module to standard output -p 


Main functions 


Delete object module from library -d -v 

Move object module to another position -m -a -b -v 
Replace or add an object module -r -a -b -c -u -v 
Print a table of contents of the library -t -s0 -s1 

Extract an object module from the library -X =v 


Table 5-1: Overview of archiver options and suboptions 
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=? 


Command line syntax 
-? 


Description 


Displays an overview of all command line options. 


Example 
The following invocations display a list of the available command line 
options: 
artc -? 
artc 


Related information 


f- 
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-d 


Command line syntax 
-d [~v] 


Description 


Delete the specified object modules from a library. With the suboption -v 
the archiver shows which files are removed. 


-v Verbose: the archiver shows which files are removed. 
Example 
artc -d lib.a objl.o obj2.o 
The archiver deletes obj1.o and obj2.o from the library lib.a. 
artc -d -v lib.a objl.o obj2.o 


The archiver deletes obj1.o and obj2.o from the library lib.a and 
displays which files are removed. 


Related information 


J- 
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-m 


Command line syntax 
—m [—a posname) |-b posname] 
Description 
Move the specified object modules to another position in the library. 


The ordering of members in a library can make a difference in how 
programs are linked if a symbol is defined in more than one member. 


Default, the specified members are moved to the end of the archive. Use 
the suboptions —a or -b to move them to a specified place instead. 


—a posname Move the specified object module(s) after 
the existing module posname. 


-b posname Move the specified object module(s) before 
the existing module posname. 


Example 


Suppose the library 1ib.a contains the following objects (see option —t): 


objl.o 
obj2.o 
obj3.o 
To move obj1.o to the end of lib.a: 
artc -m lib.a objl.o 
To move obj3.o just before obj2.o 
artc -m -b obj3.o lib.a obj2.o 
The library 1ib.a after these two invocations now looks like: 
obj3.o 


obj2.o 
objl.o 


Related information 


d> Archiver option -t (Print library contents) 
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Command line syntax 
-pP 
Description 
Print the specified object module(s) in the library to standard output. 


This option is only useful when you redirect or pipe the output to other 
files or tools that serve your own purposes. Normally you do not need this 
option. 


Example 
artc -p lib.a objl.o > file.o 
The archiver prints the file obj1.o to standard output where it is 
redirected to the file £ile.o. The effect of this example is very similar to 


extracting a file from the library but in this case the 'extracted' file gets 
another nam. 


Related information 


d> - 
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-r 


Command line syntax 


—r [~-a posname] |-b posname) [—c] [-u] [—v] 


Description 


6 


You can use the option -r for several purposes: 


e Adding new objects to the library 
e Replacing objects in the library with the same object of a newer date 
e Creating a new library 


The option -r normally adds a new module to the library. However, if the 
library already contains a module with the specified name, the existing 
module is replaced. If you specify a library that does not exist, the archiver 
creates a new library with the specified name. 


If you add a module to the library without specifying the suboption —a or 
—b, the specified module is added at the end of the archive. Use the 
suboptions —a or -b to insert them to a specified place instead. 


—a posname Add the specified object module(s) after the 
existing module posname. 


-b posname Add the specified object module(s) before 
the existing module posname. 


=c Create a new library without checking 
whether it already exists. If the library 
already exists, it is overwritten. 


-u Insert the specified object module only if it 
is newer than the module in the library. 


-=v Verbose: the archiver shows which files are 
removed. 


The suboptions -a or -b have no effect when an object is added to the 
library. 
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y 


Examples 


Suppose the library lib.a contains the following objects (see option —t): 
objl.o 
To add obj2.o to the end of lib.a: 
artc -r lib.a obj2.o 
To insert obj3.o just before obj2.o: 
artc -r -b obj2.o lib.a obj3.o 
The library lib.a after these two invocations now looks like: 
objl.o 


obj3.o 
obj2.o 


Creating a new library 


To create a new library file, add an object file and specify a library that 
does not yet exist: 


artc -r objl.o newlib.a 


The archiver creates the library newlib.a and adds the object obj1.o to 
it 


To create a new library file and overwrite an existing library, add an object 
file and specify an existing library with the supoption —c: 


artc -r -c objl.o lib.a 


The archiver overwrites the library 1ib.a and adds the object obj1.o to 
it. The new library lib.a only contains obj1.o. 


Related information 


d> Archiver option -t (Print library contents) 
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-t 


Command line syntax 
-t [-s0|-s1] 


Description 


Print a table of contents of the library to standard out. With the 
suboption —s you the archiver displays all symbols per object file. 


-s0 Displays per object the library in which it resides, the 
name of the object itself and all symbols in the object. 


-s1 Displays only the symbols of all object files in the 
library. 


Example 


artc -t lib.a 

The archiver prints a list of all object modules in the library lib.a. 
artc -t -s0 lib.a 

The archiver prints per object all symbols in the library. This looks like: 


prolog.o 

symbols: 
lib.a:prolog.o:__ Oabi callee save 
lib.a:prolog.o:__ Oabi callee restore 
divl16.o 

symbols: 
lib.a:divl6.o:__ udivl16 
lib.a:divl6.o:__ div16 
lib.a:divl6.o:__ ureml6 
lib.a:divl16.0:__ reml6 


Related information 


J- 
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-V 


Command line syntax 
-V 


Description 


Display version information. The archiver ignores all other options or 
input files. 


Example 
artc -V 


The archiver does not perform any tasks but displays the following version 
information: 


TASKING TriCore VX-toolset ELF archiver vxx.yrz Build nnn 
Copyright year Altium BV Serial# 00000000 


Related information 


de - 
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-X 


Command line syntax 
—x [-o] [—v] 
Description 
Extract an existing module from the library. 


-o Give the extracted object module the same date as the 
last-modified date that was recorded in the library. 


Without this suboption it receives the last-modified 
date of the moment it is extracted. 


-v Verbose: the archiver shows which files are extracted. 
Example 
To extract the file obj .o from the library lib.a: 
artc -x lib.a objl.o 
If you do not specify an object module, all object modules are extracted: 


artc -x lib.a 


Related information 


â - 
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-W 


Command line syntax 


—wlevel 


Description 


With this suboption you tell the archiver to suppress all warnings above 
the specified level. The level is a number between 0 — 9. 


The level of a message is printed between parentheses after the warning 
number. If you do not use the —w option, the default warning level is 8. 


Example 


To suppresses warnings above level 5: 


artc -x -w5 lib.a objl.o 


Related information 


J- 
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List File Formats 


6.1 ASSEMBLER LIST FILE FORMAT 


The assembler list file is an additional output file of the assembler that 
contains information about the generated code. 


The list file consists of a page header and a source listing. 


Page header 


The page header consists of four lines: 


TASKING TriCore VX-toolset Assembler vx.yrz Build nnn SN 00000000 
This is the page header title Page 1 


ADDR CODE CYCLES LINE SOURCE LINE 


The first line contains information about the assembler name, version 

number and serial number. The second line contains a title specified by 
the TITLE (first page) assembler directive and a page number. The third 
line is empty. The fourth line contains the heading of the source listing. 


Source listing 


The following is a sample part of a listing. An explanation of the different 
columns follows below. 


ADDR CODE CYCLES LINE SOURCE LINE 


27 ld.a al5,world 


0002 85rFrrrr 1 2 

0006 F4AF 1 3 28 stl6.a [al0],al5 

0008 91r0rr4r 1 4 29 movh.a a4,#@his(_2 ini) 
000C D944rrrr 1 5 30 lea a4,[a4]@los(_2_ ini) 
0010 1Drrrrrr 1 6 31 j printf 

0000 44 buf: .Space 4 


| RESERVED 
0003 


The meaning of the different columns is: 


ADDR This column contains the memory address. The 
address is a hexadecimal number that represents the 
offset from the beginning of a relocatable section or 
the absolute address for an absolute section. The 
address only appears on lines that generate object 
code. 
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CODE 


CYCLES 


LINE 


SOURCE LINE 
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This is the object code generated by the assembler for 
this source line, displayed in hexadecimal format. The 
displayed code need not be the same as the generated 
code that is entered in the object module. The code 
can also be relocatable code. In this case the letter ’r’ 
is printed for the relocatable code part in the listing. 
For lines that allocate space, the code field contains 
the text “RESERVED”. 


The first number in this column is the number of 
instruction cycles needed to execute the instruction(s) 
as generated in the CODE field. The second number is 
the accumulated cycle count of this section. 


This column contains the line number. This is a 
decimal number indicating each input line, starting 
from 1 and incrementing with each source line. 


This column contains the source text. This is a copy of 
the source line from the assembly source file. 


& For the . SET and . EOU directives the ADDR and CODE columns do not 
apply. The symbol value is listed instead. 


Related information 


d> See section 6.6, Generating a List File, in Chapter Using the Assembler of 
the User’s Manual for more information on how to generate a list file and 
specify the amount of list file information. 


List File Formats 


6.2 LINKER MAP FILE FORMAT 


The linker map file is an additional output file of the linker that shows 
how the link phase has mapped the sections and symbols from the various 
object files (. o) to output sections. The locate part shows the absolute 
position of each section. External symbols are listed per space with their 
absolute address, both sorted on symbol and sorted on address. 


With the linker option -m (map file formatting) you can specify which 
parts of the map file you want to see. 


Example (part of) linker map file 


JERI ICC I EEE: Processed Files Part 2 I i*iiiidddikiciaiddickicicidii x a imax & 


fran nnn nnn nnn nat 
| File | From archive | Symbol causing the extraction | 
| cstart.o | libc.a | _START | 
| hello.o | | 
| printf.o | libc.a | printf | 
+---------------------------------------------------------+ 


JE II K Ae A AE E A E A ii i p k Part, ecg e ganna id 


+-----------------------------------------------------------------------------+ 
| [in] File | [in] Section | [in] Size | [out] Offset | [out] Section | 
|=== == 

| hello.o | .text.hello.main | 0x00000014 | 0x00000000 | .text.hello.main | 
| — a pn a a a a ef a et a a i gf i a 
| cstart.o | .text.libc | 0x00000202 | 0x00000000 | .text.libc | 
| strcpy.o | .text.libc | 0x00000024 | 0x00000204 | | 
| printf.o | .text.libc | 0x0000002c | 0x00000800 | | 


| cstart.o | .text.libc.reset | 0x00000008 | 0x00000000 | .text.libc.reset | 


LE nn nn nn nn OI I 


JESS ICO IOC CISC kxk xxx Module Local Symbols Part ?JO*?GOGGBOGGOGIG GG IOG III I 


* Symbol translation (sorted on name) 


+ Scope "./hello.o" 


I ——— - == === - == == == === === + 
| Name | Address | Space | 
| hello.src | 0x00000000 | - | 
| .rodata.hello | 0xa00000e0 | spe:tc:linear | 
| .text.hello.main | 0xa00000f8 | | 
| .zdata.hello | Oxd0000000 | spe:tc:absl8 | 
| .zrodata.hello | 0xa0000008 | | 
I ———— UO OO == === = + 


TriCore Reference Manual 


FEISS iH Hc COCCHI Cross Reference Part >% kid kii k AA KA KAA KKA K 


Definition file | Definition section | Symbol | Referenced in | 


l 

l | 
| _doprint_int.o | .libc | _ printf_ | printf_int.o 

| _doprint_int.o | .text.libc | _doprint | printf.o | 
| cstart.o | «text.libc | _start | hello.o | 
| cstart.o | .text.libc.reset | _START | | 
| hello.o | .text.hello.main | main | cstart.o | 
| printf.o | .text.libe | printf | hello.o | 
en + 


JESSIE IIS GR GG iW. Cal]. Graph Part ?FFIGGHGOUG FRO FF EGG e K EG GG RCH 


JESS ICH IG RG GG GSG GG GG EW. ()yer] ay. Part ?OG/SIGIOGI GOG GIG I ESSER GIG IIT IG I 


JI I ICI ISI IIIS IEEE Locate Part Je??? iai IR GG IH k k GI GG CH k A k 


* Task entry address 


+- =----------+ 
| symbol | _START | 
| absolute address | 0xa0000000 | 
+-------------------------------+ 
* Section translation 
+ Space spe:tc:linear 
I ——————— nt 
Chip Group Section Size (MAU) | Space addr | Chip addr 
0x00000008 | 0xa0000000 | 0x00000000 
[.data.libc] 0x000000cc | 0xa0000010 | 0x00000010 
[.zdata.hello] 0x00000004 | 0xa00000dc | 0x000000dc 
.rodata.hello 0x0000000c | 0xa00000e0 | 0x000000e0 
.rodata.libc 0x0000000c | 0xa00000ec | 0x000000ec 
.text.hello.main 0x00000014 | 0xa00000f8 | 0x000000f8 
.text.libc.csa areas | 0x00000008 | 0xa000010c | 0x0000010c 
table 0x00000034 | 0xa0000114 | 0x00000114 
libraries | .text.libc 0x00000eae | 0xa0004000 | 0x00004000 
frre ' í AO 
+ Space spe:tc:abs18 
fr et 
| Group | Section | Size (MAU) | Space addr | Chip addr | 
| ext_c | | .zrodata.hello | 0x00000006 | 0xa0000008 | 0x00000008 | 
| spe:dsram | | .zdata.hello | 0x00000004 | 0xd0000000 | 0x00000000 | 
I —————————í «I ————íoU 


* Symbol translation (sorted on name) 


_A8 DATA_ 0x00000000 
TExit 0xa0004170 
START 


l | l | 
| | | | 
pa | 0xa0000000 | | 
| _lc_gb_int_tab | 0x00000000 | | 
| _lc ge int_tab | 0x00000000 | | 
| main | 0xa00000f8 | | 
| world | 0xd0000000 | spe:tc:abs18 | 

8 


pele Rael xm a YY CETA E EA EN 


List File Formats 


* Symbol translation (sorted on address) 


+ 
| 

I= | 
| 0x00000000 | _1c_ge_int_ | spe inear | 
| 0x00000000 | _Ic gb int tab | | 
| 0x00000000 | -A8 DATA_ | 

| 0xa0000000 | _START | | 
| 0xa00000f8 | main | | 
| 0xa0004170 | _Exit | | 
| 0xd0000000 | world | spe:tc:abs18 | 
+-=-------------------------------------------+ 


JE IS SII ICI A R k Memory. Part SO Rk AA k A I IG AA A K A A 


* Address range usage at space level 


EE DN a r A DYF FYN 


| > free gap 


| 0x00007eba 

| 0x500017e0 99 
| 

| 

| 


99 | 0x00004000 
Ox2ffOdf0a 59 
0x00004fc0 83 
0x0004f878 59 
| spe:tc:pcp code | 0x00002000 | 0x00000000 0x00002000 100 | 0x00002000 100 


| 
| 
| 
| 
| spe:tc:pcp data | 0x00000400 | 0x00000000 © | 0x00000400 100 | 0x00000400 100 | 
+ 


ee a e HY a ee ee ee FAWR YY ee ee ee a ee ee eee ae eee ee ee 


| 0x00008000 

| 0x50024000 | 0x00022820 

| 0x00006000 | 0x00001004 1 
| 0x00085000 | 0x00021788 2 


0x00000146 


0x00004ffc 83 
0x00063878 74 


* Address range usage at memory level 


FRO oa FU are ie laa 


> free gap % 
ext_c 0x00080000 | 0x00000ff4 1 | 0x0007f00c 99 | 0x0007b152 96 
ext_c2 0x00080000 | 0x00000000 0 | 0x00080000 100 | 0x00080000 100 
ext_d 0x00070000 | 0x00020784 29 | 0x0004f87c 71 | 0x0004f878 71 
spe:brom 0x00008000 | 0x00000000 0 | 0x00008000 100 | 0x00008000 100 
spe:csram 0x00006000 | 0x00000000 0 | 0x00006000 100 | 0x00006000 100 
spe:dsram 0x00006000 | 0x00001004 17 | 0x00004ffc 83 | 0x00004fc0 83 
spe:fpidram | 0x00004000 | 0x00000000 0 | 0x00004000 100 | 0x00004000 100 
spe:pcode 0x00004000 | 0x00000000 0 | 0x00004000 100 | 0x00004000 100 
spe:pram 0x00001000 | 0x00000000 0 | 0x00001000 100 | 0x00001000 100 
vecttable 0x00002400 | 0x000000a4 2 | 0x0000235c 98 | 0x00002000 88 

Hert —— 


TII GG RG GR WYW. Linker Script File Part OR?” I3OR””GGGGOGGG GG GG GGROk 


JERI I ICI IO kk kkk kkk kkk Locate Rule Part Rt i*iiiaiddidiikcicidi i e e HR Ik 


.text.libc 


absolute 


| | | | 
| clustered | | .zdata.hello | 
| clustered | | «data.libc | 
| ordered | | .text.trapvec.000 < .text.trapvec.001 ... | 
| unrestricted | | .zrodata.hello | 
| unrestricted | | ustack | 
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The meaning of the different parts is: 


Processed Files Part 


This part of the map file shows all processed files. This also includes 
object files that are extracted from a library, with the symbol that led to the 
extraction 


Link Part 


This part of the map file shows per object file how the link phase has 
mapped the sections from the various object files (. o) to outpuc sections. 


[in] File The name of an input object file. 

[in] Section A section name from the input object file. 

[in] Size The size of the input section. 

[out] Offset The offset relative to the start of the output section. 


[out] Section The resulting output section name. 


Module Local Symbols Part 


This part of the map file shows a table for each local scope within an 
object file. Each table has three columns, 1 the symbol name, 2 the 
address of the symbol and 3 the space where the symbol resides in. The 
table is sorted on symbol name within each space. 


By default this part is not shown in the map file. You have to turn this part 
on manually with linker option -mg (module local symbols). 


Cross Reference Part 


This part of the map file lists all symbols defined in the object modules 
and for each symbol the object modules that contain a reference to the 
symbol are shown. 


Call Grapb Part 


This part of the map file contains a schematic overview that shows how 
(library) functions call each other. To obtain call graph information, the 
assembly file must contain . CALLS directives which you must manually 
add to the assembly source. 
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Overlay Part 


This part is empty for the TriCore. 


Locate Part: Section translation 


This part of the map file shows the absolute position of each section in the 


absolute object file. It is organized per address space, memory chip and 
group and sorted on space address. 


+ Space 


Chip 


Group 


Section 


Size (MAU) 


Space addr 


Chip addr 


The names of the address spaces as defined in the 
linker script file (tc*.1s1). The names are 
constructed of the derivative name followed by a 
colon ’:, the core name, another colon ’:’ and the 
space name. For example: spe:tc:linear 


The names of the memory chips as defined in the 
linker script file (*. 1s1) in the memory definitions. 


Sections can be ordered in groups. These are the 
names of the groups as defined in the linker script file 
(*.lsl) with the keyword group in the 

section layout definition. The name that is 
displayed is the name of the deepest nested group. 


The name of the section. Names within sguare 
brackets [ ] will be copied during initialization from 
ROM to the corresponding section name in RAM. 


The size of the section in minimum addressable units. 


The absolute address of the section in the address 
space. 


The absolute offset of the section from the start of a 
memory chip. 


Locator Part: Symbol translation 


This part of the map file lists all external symbols per address space name, 
both sorted on symbol name and sorted on address. 


Name 


Address 


The name of the symbol. 


The absolute address of the symbol in the address 
space. 
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Space The names of the address spaces as defined in the 
linker script file (tc*.1s1). The names are 
constructed of the derivative name followed by a 
colon ’:’, the core name, another colon ’:’ and the 
space name. For example: spe:tc:linear 


Memory Part 


This part of the map file shows the memory usage in totals and 
percentages for spaces and chips. The largest free block of memory per 
space and per chip is also shown. 


By default this part is not shown in the map file. You have to turn this part 
on manually with linker option -mm (memory usage info). 


Linker Script File Part 


This part of the map file shows the processor and memory information of 
the linker script file. 


By default this part is not shown in the map file. You have to turn this part 
on manually with linker option -ms (processor and memory info). You 
can print this information to a separate file with linker option 
—-Isl-dump. 


Locate Rule Part 


This part of the map file shows the rules the linker uses to locate sections. 


Address space The names of the address spaces as defined in the 
linker script file (*. 1s1). The names are constructed 
of the derivative name followed by a colon :”, the 
core name, another colon °: and the space name. 
For example: spe:tc:linear 


Type The rule type: 


ordered/contiguous/clustered/unrestricted 
Specifies how sections are grouped. By 
default, a group is 'unrestricted' which 
means that the linker has total freedom to 
place the sections of the group in the 
address space. 


absolute address The section must be located at the address 
shown in the Properties column 
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address range The section must be located in the union of 
the address ranges shown in the Properties 
column; end addreses are not included in 
the range. 


address range size The sections must be located in some 
address range with size not larger than 
shown in the Properties column; the second 
number in that field is the alignment 
reguirement for the address range. 


ballooned After locating all sections, the largest 
remaining gap in the space is used 
completely for the stack and/or heap. 


Properties The contents depends on the Type column. 


Sections The sections to which the rule applies; 

restrictions between sections are shown in this 
column: 

< ordered 

| contiguous 

+ clustered 
For contiguous sections, the linker uses the section 
order as shown here. Clustered sections can be located 
in any relative order. 


Related information 


d> Section 7.9, Generating a Map File, in Chapter Using the Linker of the 
User's Manual. 


Linker option -M (Generate map file) 
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Object File Formats 


7.1_ ELFDWARF OBJECT FORMAT 


The TriCore toolchain by default produces objects in the ELF/DWARF 2 
(.elf) format. 


The ELF/DWARF 2 Object Format for the TriCore toolchain follows the 
convention as described in the TriCore Embedded Application Binary 
Interface [2000, Infineon]. 


For a complete description of the ELF and DWARF formats, please refer to 
the Tool Interface Standard (TIS). 
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7.2 MOTOROLA S-RECORD FORMAT 


With the linker option -oftlename:SREC option the linker produces output 
in Motorola S-record format with three types of S-records: S0, S2 and S8. 
With the options -ofilename:SREC:2 or -ofilename:SREC:4 option you 
can force other types of S-records. They have the following layout: 


SO - record 
’S’ 'O' <length_byte> <2 bytes 0> <comment> <checksum_byte> 


A linker generated S-record file starts with a SO record with the following 
contents: 


length byte : 0x6 
comment : lte (TriCore linker) 
checksum _ : OxB6 


ltc 
S00600006C7463B6 


The S0 record is a comment record and does not contain relevant 
information for program execution. 


The length byte represents the number of bytes in the record, not 
including the record type and length byte. 


The checksum is calculated by first adding the binary representation of the 
bytes following the record type (starting with the length byte) to just 
before the checksum. Then the one's complement is calculated of this 
sum. The least significant byte of the result is the checksum. The sum of 
all bytes following the record type is OxFF. 


S1 - record 


With the linker option -oftlename:SREC:2, the actual program code and 
data is supplied with S1 records, with the following layout: 


S T <length_byte> <address> <code bytes> <checksum_byte> 


This record is used for 2-byte addresses. 
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Example: 


S1130250F03EF04DFOACE8A408A2A013EDFCDBO0E6 
| | | |_ checksum 
| | |_ code 
| |_ address 

|_ length 


The linker has an option that controls the length of the output buffer for 
generating S1 records. The default buffer length is 32 code bytes. 


The checksum calculation of S1 records is identical to SO. 


S2 - record 


With the linker option -oftlename:SREC:3, which is the default, the actual 
program code and data is supplied with S2 records, with the following 
layout: 


S '2' <length_byte> <address> <code bytes> <checksum_byte> 
For the TriCore the linker generates 3—byte addresses. 
Example: 


S213FF002000232222754E00754F04AF4FAE4E22BF 
| | | |_ checksum 
| | |_ code 
| |_ address 

|_ length 


The linker has an option that controls the length of the output buffer for 
generating S2 records. The default buffer length is 32 code bytes. 


The checksum calculation of S2 records is identical to SO. 


S3 - record 


With the linker option —ofi/emame:SREC:4, the actual program code and 
data is supplied with S3 records, with the following layout: 


S '3' <length_byte> <address> <code bytes> <checksum_byte> 


This record is used for 4—byte addresses. 
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Example: 


S3070000FFFE6E6825 
| | | |_ checksum 
| | |_ code 
| |_ address 

|_ length 


The linker has an option that controls the length of the output buffer for 
generating S3 records. 


The checksum calculation of S3 records is identical to SO. 


S7 - record 


With the linker option -oftlename:SREC:4, at the end of an S-record file, 
the linker generates an S7 record, which contains the program start 
address. S7 is the corresponding termination record for S3 records. 


Layout: 
S T7 <length_byte> <address> <checksum_byte> 
Example: 


S70500006E6824 
| | | checksum 
| |_ address 
|_ length 


The checksum calculation of S7 records is identical to SO. 


S8 - record 


With the linker option -oftlename:SREC:3, which is the default, at the end 
of an S-record file, the linker generates an S8 record, which contains the 
program start address. 


Layout: 
’S’ '8' <length_byte> <address> <checksum_byte> 
Example: 


S804FF0003F9 
| | | checksum 
| |_ address 
|_ length 
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The checksum calculation of S8 records is identical to SO. 


S9 - record 


With the linker option -oftlename:SREC:2, at the end of an S-record file, 
the linker generates an S9 record, which contains the program start 
address. S9 is the corresponding termination record for S1 records. 


Layout: 
'S” '9” <length_byte> <address> <checksum_byte> 
Example: 


S9030210EA 
| | | checksum 
| |_ address 
|_ length 


The checksum calculation of S9 records is identical to SO. 
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7.3 INTEL HEX RECORD FORMAT 


Intel Hex records describe the hexadecimal object file format for 8-bit, 
16-bit and 32-bit microprocessors. The hexadecimal object file is an ASCII 
representation of an absolute binary object file. There are six different 
types of records: 

e Data Record (8-, 16, or 32-bit formats) 

e End of File Record (8-, 16, or 32-bit formats) 

e Extended Segment Address Record (16, or 32-bit formats) 

e Start Segment Address Record (16, or 32-bit formats) 

e Extended Linear Address Record (32-bit format only) 

e Start Linear Address Record (32-bit format only) 


For the TriCore the linker generates records in the 32-bit format (4—byte 
addresses with linker option -ofilename:ITHEX). 


General Record Format 


In the output file, the record format is: 


is the record header. 


length is the record length which specifies the number of bytes of 
the content field. This value occupies one byte (two 
hexadecimal digits). The linker outputs records of 255 bytes 
(32 hexadecimal digits) or less; that is, length is never greater 
than OxFF. 


offset is the starting load offset specifying an absolute address in 
memory where the data is to be located when loaded by a 
tool. This field is two bytes long. This field is only used for 
Data Records. In other records this field is coded as four 
ASCII zero characters (0000. 


type is the record type. This value occupies one byte (two 
hexadecimal digits). The record types are: 
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Byte Type Record type 

00 Data 
01 End of File 
02 Extended segment address (not used) 
03 Start segment address (not used) 
04 Extended linear address (32-bit) 
05 Start linear address (32-bit) 

content is the information contained in the record. This depends on 


checksum 


the record type. 


is the record checksum. The linker computes the checksum 
by first adding the binary representation of the previous 
bytes (from length to content). The linker then computes the 
result of sum modulo 256 and subtracts the remainder from 
256 (two’s complement). Therefore, the sum of all bytes 
following the header is zero. 


Extended Linear Address Record 


The Extended Linear Address Record specifies the two most significant 


bytes (bits 16 


-31) of the absolute address of the first data byte in a 


subseguent Data Record: 


02 


0000 upper address checksum 


The 32-bit absolute address of a byte in a Data Record is calculated as: 


( address + offset + index ) modulo 4G 


where: 


address 


offset 


index 


is the base address, where the two most significant bytes are 
the upper_address and the two least significant bytes are 
zero. 


is the 16-bit offset from the Data Record. 


is the index of the data byte within the Data Record (0 for 
the first byte). 


7-9 


7-10 TriCore Reference Manual 


- 


Example: 


:0200000400FFFB 

| | | |_ checksum 
| | |_ upper address 
|  |_ type 

|_ offset 

length 


Data Record 


The Data Record specifies the actual program code and data. 


length offset 00 data Ea 


The length byte specifies the number of data bytes. The linker has an 
option that controls the length of the output buffer for generating Data 
records. The default buffer length is 32 bytes. 


The offset is the 16-bit starting load offset. Together with the address 
specified in the Extended Address Record it specifies an absolute address 
in memory where the data is to be located when loaded by a tool. 


Example: 


| | | |_ checksum 
| | |_ data 

|  |_ type 

|_ offset 


:0F00200000232222754E00754F04AF4FAE4E22C3 
| 
| 
| 
| 
|_ length 


Object File Formats 7-11 


Start Linear Address Record 


The Start Linear Address Record contains the 32-bit program execution 
start address. 


Layout: 
04 0000 05 address checksum 


Example: 


:0400000500FF0003F5 

| | | |_ checksum 
| | |_ address 

|  |_ type 

|_ offset 


End of File Record 


The hexadecimal file always ends with the following end—of-file record: 


:00000001FF 
| | | |_ checksum 
| | | type 
| |_ offset 
|_ length 
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Linker Script Language 


8.1 INTRODUCTION 


To make full use of the linker, you can write a script with information 
about the architecture of the target processor and locating information. 
The language for the script is called the Linker Script Language (LSL). This 
chapter first describes the structure of an LSL file. The next section 
contains a summary of the LSL syntax. Finally, in the remaining sections, 
the semantics of the Linker Script Language is explained. 


The TASKING linker is a target independent linker/locator that can 
simultaneously link and locate all programs for all cores available on a 
target board. The target board may be of arbitrary complexity. A simple 
target board may contain one standard processor with some external 
memory that executes one task. A complex target board may contain 
multiple standard processors and DSPs combined with configurable 
IP—cores loaded in an FPGA. Each core may execute a different program, 
and external memory may be shared by multiple cores. 


LSL serves two purposes. First it enables you to specify the characteristics 
(that are of interest to the linker) of your specific target board and of the 
cores installed on the board. Second it enables you to specify how 
sections should be located in memory. 


8.2 STRUCTURE OF A LINKER SCRIPT FILE 


A script file consists of several definitions. The definitions can appear in 
any order. 


The architecture definition (required) 


In essence an architecture definition describes how the linker should 
convert logical addresses into physical addresses for a given type of core. 
If the core supports multiple address spaces, then for each space the linker 
must know how to perform this conversion. In this context a physical 
address is an offset on a given internal or external bus. Additionally the 
architecture definition contains information about items such as the 
(hardware) stack and the interrupt vector table. 


This specification is normally written by Altium. The architecture definition 
of the LSL file should not be changed by you unless you also modify the 
core’s hardware architecture. If the LSL file describes a multi-core system 
an architecture definition must be available for each different type of core. 
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See section 8.5, Semantics of the Architecture Definition for detailed 
descriptions of LSL in the architecture definition. 


Tbe derivative definition (reguired) 


The derivative definition describes the configuration of the internal 
(on-chip) bus and memory system. Basically it tells the linker how to 
convert offsets on the buses specified in the architecture definition into 
offsets in internal memory. A derivative definition must be present in an 
LSL file. Microcontrollers and DSPs often have internal memory and I/O 
sub-systems apart from one or more cores. The design of such a chip is 
called a derivative. 


Altium provides LSL descriptions of supported derivatives, along with "SFR 
files”, which provide easy access to registers in I/O sub-systems from C 
and assembly programs. When you build an ASIC or use a derivative that 
is not (yet) supported by the TASKING tools, you may have to write a 
derivative definition. 


When you want to use multiple cores of the same type, you must 
instantiate the cores in a derivative definition, since the linker 
automatically instantiates only a single core for an unused architecture. 


d> See section 8.6, Semantics of the Derivative Definition for a detailed 
description of LSL in the derivative definition. 


The processor definition 


The processor definition describes an instance of a derivative. A processor 
definition is only needed in a multi-processor embedded system. It allows 
you to define multiple processors of the same type. 


See section 8.7, Semantics of the Board Specification for a detailed 
description of LSL in the processor definition. 


The memory and bus definitions (optional) 


Memory and bus definition are used within the context of a derivative 
definition to specify internal memory and on-chip buses. In the context of 
a board specification the memory and bus definitions are used to define 
external (off-chip) memory and buses. Given the above definitions the 
linker can convert a logical address into an offset into an on-chip or 
off-chip memory device. 
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See section 8.7.3, Defining External Memory and Buses, for more 
information on how to specify the external physical memory layout. 
Internal memory for a processor should be defined in the derivative 
definition for that processor. 


Tbe board specification 


The processor definition and memory and bus definitions together form a 
board specification. LSL provides language constructs to easily describe 
single-core and heterogeneous or homogeneous multi-core systems. The 
board specification describes all characteristics of your target board's 
system buses, memory devices, I/O sub-systems, and cores that are of 
interest to the linker. Based on the information provided in the board 
specification the linker can for each core: 


e convert a logical address to a physical addresses (offsets within a 
memory device) 


e locate sections in physical memory 


e maintain an overall view of the used and free physical memory within 
the whole system while locating 


Tbe section layout definition (optional) 


The optional section layout definition enables you to exactly control 
where input sections are located. Features are provided such as: the 
ability to place sections at a given load—address or run-time address, to 
place sections in a given order, and to overlay code and/or data sections. 


Which object files (sections) constitute the task that will run on a given 
core is specified on the command line when you invoke the linker. The 
linker will link and locate all sections of all tasks simultaneously. From the 
section layout definition the linker can deduce where a given section may 
be located in memory, form the board specification the linker can deduce 
which physical memory is (still) available while locating the section. 


See section 8.8, Semantics of the Section Layout Definition,, for more 
information on how to locate a section at a specific place in memory. 


Skeleton of a Linker Script File 


The skeleton of a linker script file now looks as follows: 


architecture architecture_ name 


{ 


architecture definition 
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derivative derivative_ name 


{ 

derivative definition 
} 
processor processor name 
{ 

processor definition 
} 


memory definitions and/or bus definitions 


section layout space name 


{ 


section placement statements 


} 


8.3 SYNTAX OF THE LINKER SCRIPT LANGUAGE 


8.3.1 PREPROCESSING 


When the linker loads an LSL file, the linker processes it with a C-style 
prepocessor. As such, it strips C and C++ comments. You can use the 
standard ISO C preprocessor directives, such as #include, #define, 
#if/#else/#endif. 


For example: 
#include "arch.1sl” 


Preprocess and include the file arch.1s1 at this point in the LSL file. 
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8.3.2 LEXICAL SYNTAX 


The following lexicon is used to describe the syntax of the Linker Script 


Language: 

A ::= B = A is defined as B 

A ::=BC = A is defined as B and C; B is followed by C 

A ::= B | C- = A is defined as B or C 

<B>0|1 = zero or one occurrence of B 

<B>>70 = zero of more occurrences of B 

<B>?=1 = one of more occurrences of B 

IDENTIFIER = a character sequence starting with 'a'—z', 'A'—'Z or’. 
Following characters may also be digits and dots ’.’ 

STRING = sequence of characters not starting with \n, \r or \t 

DOSTRING =" STRING " (double quoted string) 

OCT NUM = octal number, starting with a zero (06, 045) 

DEC_NUM = decimal number, not starting with a zero (14, 1024) 

HEX NUM = hexadecimal number, starting with ’0x’ (0x0023, 0xFF00) 


OCT_NUM, DEC_NUM and HEX_NUM can be followed by a k (kilo), M 
(mega), or G (giga). 


Characters in bold are characters that occur literally. Words in /Ia/ics are 
higher order terms that are defined in the same or in one of the other 
sections. 


To write comments in LSL file, you can use the C style '/* = */' or C++ 
style '//”. 


8.3.3 IDENTIFIERS 


arch name ::= IDENTIFIER 
bus_name ::= IDENTIFIER 
core_name ::—- IDENTIFIER 
derivative_name ::= IDENTIFIER 
file name ::= DOSTRING 
group name ::— IDENTIFIER 
mem name ::= IDENTIFIER 
proc_name ::—- IDENTIFIER 
section_name ::= DOSTRING 
space_name ::- IDENTIFIER 
stack name ::= section name 
symbol name ::= DOSTRING 
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The expressions and operators in this section work the same as in ISO C. 


number 


expr 


unary_op 


binary _op 


OCT_NUM 
DEC_NUM 
HEX NUM 


number 
symbol_name 

unary _op expr 

expr binary_op expr 
expr ? expr : expr 


( expr ) 


function_call 


// 
// 
// 


logical NOT 
bitwise complement 
negative value 


exclusive OR 
multiplication 
division 

modulus 

addition 

subtraction 

right shift 

left shift 

equal to 

not equal to 

greater than 

less than 

greater than or equal to 
less than or equal to 
bitwise AND 

bitwise OR 

logical AND 

logical OR 
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8.3.5 BUILT-IN FUNCTIONS 


function_call = absolute ( expr ) 

| addressof ( addr id ) 

| exists ( section name ) 
| max ( expr , expr ) 

| min ( expr , expr ) 

| sizeof ( size id ) 


addr_ id = sect : section name 
| mem : mem name 
| group : group name 
size id group : group name 


| mem : mem name 
| sect : section name 


e Every space, bus, memory, section or group your refer to, must be 
defined in the LSL file. 


e The addressof() and sizeof() functions with the group or 
sect argument can only be used in the right hand side of an 
assignment. The sizeof() function with the mem argument can be 
used anywhere in section layouts. 


You can use the following built-in functions in expressions. All functions 
return a numerical value. This value is a 64-bit signed integer. 


absolute() 
int absolute( expr ) 


Converts the value of expr to a positive integer. 


absolute( "labelA”-"labelB” ) 


addressof() 
int addressof( addr id ) 


Returns the address of addr_id, which is a named section, group or 
memory. To get the offset of the section with the name asect: 


addressof( sect: "asect”) 


& This function only works in assignments. 
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exists() 
int exists( section name ) 


The function returns 1 if the section section name exists in one or more 
object file, 0 otherwise. If the section is not present in input object files, 
but generated from LSL, the result of this function is undefined. 


To check whether the section mysection exists in one of the objecc files 
that is specified to the linker: 


exists( "mysection” ) 


ma«x() 
int max( expr, expr ) 


Returns the value of the expression that has the largest value. To get the 
highest value of two symbols: 


max( “syml” , ”“sym2”) 
min() 
int min( expr, expr ) 


Returns the value of the expression hat has the smallest value. To get the 
lowest value of two symbols: 


min( “syml” , "sym2”) 
sizeofQ 
int sizeof( size id ) 


Returns the size of the object (group, section or memory) the identifier 
refers to. To get the size of the section "asection”: 


sizeof( sect: "asection” ) 


& The group and sect arguments only works in assignments. The mem 
argument can be used anywhere in section layouts. 
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8.3.6 LSL DEFINITIONS IN THE LINKER SCRIPT FILE 


description ::= <definition>?=1 


definition ::= architecture definition 
derivative definition 

| board spec 

| section definition 


e At least one architecture definition must be present in the 
LSL file. 


8.3.7 MEMORY AND BUS DEFINITIONS 


mem def ::= memory mem name { <mem descr ;>>70 } 


e A mem def defines a memory with the mem_ name as a unique 
name. 


type = <reserved>0|l mem type 
mau = expr 


mem_descr 235 
| 
| size = expr 
| 
| 


speed = number 

mapping 
e Amem def contains exactly one type statement. 
e Amem def contains exactly one mau statement (non-zero size). 
e A mem def contains exactly one size statement. 


e A mem def contains zero or one speed statement 
(default value is 1). 


e A mem def contains at least one mapping. 


mem type ::= rom // attrs = rx 

| ram // attrs = rw 

| nvram // attrs = rwx 
bus_def ::= bus bus name { <bus descr ;>7?=° } 


e A bus def statement defines a bus with the given bus_name as a 
unigue name within a core architecture. 


bus_descr Es 


// of data bits 
mapping // legal destination 
// 'bus' only 


| width = expr // bus width, nr 
| 
| 
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mapping 


map descr : 


destination 23 


range 
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The mau and width statements appear exactly once in a 
bus_descr. The default value for width is the mau size. 


The bus width must be an integer times the bus MAU size. 
The MAU size must be non-zero. 


A bus can only have a mapping on a destination bus (through 
dest = bus: ). 


map ( map descr <, map_descr>?=9 ) 


dest = destination 
dest_dbits = range 
dest_offset = expr 
size = expr 
src_dbits = range 
src_offset = expr 


A mapping requires at least the size and dest statements. 

Each map_descr can occur only once. 

You can define multiple mappings from a single source. 

Overlap between source ranges or destination ranges is not allowed. 


If the src_dbits or dest_dbits statement is not present, its value 
defaults to the width value if the source/destination is a bus, and to 
the mau size otherwise. 


= space : space name 
| bus : <proc name 
core name :>°|1 bus name 


A space_name refers to a defined address space. 

A proc_name refers to a defined processor. 

A core_name refers to a defined core. 

A bus_name refers to a defined bus. 

The following mappings are allowed (source to destination) 
— space => space 

— space => bus 

- bus => bus 


- memory => bus 


::= number ee number 
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8.3.8 


ARCHITECTURE DEFINITION 


architecture definition 


::= architecture arch name 
<( parameter list )>9l|1 
<extends arch name 
<( argument list )>0|1 >0|1 
(arch spec>”?0 } 


An architecture definition defines a core architecture with 
the given arch name as a unique name. 


At least one space_def and at least one bus_def have to be 
presentin an architecture definition. 


An architecture definition that uses the extends construct 
defines an architecture that inherits all elements of the architecture 
defined by the second arch_name. The parent arcbitecture must 
be defined in the LSL file as well. 


parameter list ::= parameter <, parameter>>”0 
parameter ::= IDENTIFIER <= expr>0|l 
argument_list ::= expr <, expr>?=0 


arch_spec 


= bus_def 
| space_def 
| endianness_def 


space def ::= space space name { <space descr;>>70 } 


space descr 23 


space property i 


A space_ def defines an address space with the given 
space_name as a unigue name within an architecture. 


= space property ; 
| section definition //no space ref 


= id = number // as used in object 
| mau = expr 

| align = expr 

| page_size = expr 

| stack_def 

| heap def 

| copy table def 

| start address 

| mapping 


A space_ def contains exactly one id and one mau statement. 


8-14 


TriCore Reference Manual 


e A space def contains at most one align statement. 
e A space def contains at most one page_size statement. 


e A space def contains at least one mapping. 


stack def ::= stack stack name ( stack heap descr 
<, stack heap descr >>=0 ) 


e A stack def defines a stack with the stack_name as a unique 
name. 


heap def ::= heap heap name ( stack heap descr 
<, stack heap descr >?=9 ) 


e A heap def defines a heap with the heap_name as a unique 
name. 


copy_table def ::= copytable ( copy table descr 
<, copy table _descr>?=° ) 


e A space def contains at most one copytable statement. 


e If the architecture definition contains more than one address space, 
exactly one copy table must be defined in one of the spaces. If the 
the architecture definition contains only one address space, a copy 
table definition is optional (it will be generated in the space). 


stack heap descr = min_size = expr 
| grows = direction 
| align = expr 


fixed 


e The min_size statement must be present. 


e You can specify at most one align statement and one grows 
statement. 


direction ::= low_to_high 
| high _to_low 


e If you do not specify the grows statement, the stack and grow 
low-to-high. 


copy_table descr = align = expr 
| copy_unit = expr 
| 


dest <space name>0|l = space name 
e The copy _unit is defined by the size in MAUs in which the startup 
code moves data. 


e The dest statement is only required when the startup code 
initializes memory used by another processor that has no access to 
ROM. 
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A space_name refers to a defined address space. 


start_addr ::= start_address ( start addr descr 


start_addr_descr :: 


<, start_addr_descr>>=° ) 


= run_addr = expr 
| symbol = symbol name 


A symbol name refers to the section that contains the startup code. 


endianness_def ::= endianness { <endianness type;>7=1 ) 
endianness_type :: big 
| little 


8.3.9 


DERIVATIVE DEFINITION 


derivative definition 


::= derivative derivative name 
<( parameter list )>0|1 
<extends derivative_ name 
<( argument list )>0|1 >0|1 
{ <derivative spec>>70 } 


A derivative definition defines a derivative with the given 
derivative_name as a unigue name. 


At least one core_def must be present in a 
derivative definition. 


derivative_ spec ::= core def 
| bus def 
| mem def 
| section definition // no processor 
// name 
core def 2:= core core name { <core descr ;>7=9 } 


A core_def defines a core with the given core_name as a unique 
name. 


core_descr ::= architecture = arch name 


<( argument list )>0|1 
| endianness = ( endianness_type 
<, endianness_type>?=° ) 


An arch_name refers to a defined core architecture. 
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e Exactly one architecture statement must be present in a 
core def. 


8.3.10 PROCESSOR DEFINITION AND BOARD 


SPECIFICATION 
board spec ::= proc def 
| bus def 
| mem def 
proc def ::= processor proc name 


{ proc descr ; } 


proc descr 


derivative - derivative_ name 
<( argument list )>0|1 


e A proc def defines a processor with the proc_name as a unique 
name. 


e If you do not explicitly define a processor for a derivative in an LSL 
file, the linker defines a processor with the same name as that 
derivative. 


e A derivative_ name refers to a defined derivative. 


e A proc def contains exactly one derivative statement. 


8.3.11 SECTION PLACEMENT DEFINITION 


section definition ::- section layout <space ref>0|l 
<( locate direction )>0|1 
{ <section statement>>”0 } 


e A section definition inside a space definition does not have a 
space ref. 
e All global section definitions have a space ref. 
space ref ::= <proc name>0|l + <core name>0|l 
* space name 
e If more than one processor is present, the proc_name must be 
given for a global section layout. 


e If the section layout refers to a processor that has more than one 
core, the core_name must be given in the space ref. 


e A proc name refers to a defined processor. 


Linker Script Language 


e A core_name refers to a defined core. 


e A space _name refers to a defined address space. 


locate_direction ::= direction = direction 


direction ::= low_to_high 


| high _to_low 
e A section layout contains at most one direction statement. 


e If you do not specify the direction statement, the locate direction 
of the section layout is low-to—high. 


section_statement 
= simple section statement ; 
| aggregate_section_statement 


simple_section_statement 
::= assignment 
| select_section_statement 
| special_section_statement 


assignment ::= symbol_name assign_op expr 


assign_op 


select_section_statement 
::= select <section_name>°|1 
<section_selections>9|1 


e Either a section_name or at least one section_selection must 


be defined. 


section_selections 
::= ( section selection 
<, section selection>>”0 ) 


section selection 


::= attributes = < <+|-> attribute>>? 


e +attribute means: select all sections that have this attribute. 


e -attribute means: select all sections that do not have this 
attribute. 
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special section statement 


::= heap stack name <size_spec>9|1 
| stack stack name <size spec>0l! 
| copytable 


reserved <section name>0|l 
<reserved specs>0ll 


e Special sections cannot be selected in load-time groups. 
size spec ::— ( size = expr ) 


reserved specs ::= ( reserved spec 
<, reserved spec>>”? ) 


= attributes 
| fill spec 

| size = expr 

| alloc allowed - absolute 


reserved spec 2: 


e Ifa reserved section has attributes r, rw, x, rx or rwx, and no fill 
pattern is defined, the section is filled with zeros. If no attributes are 
set, the section is created as a scratch section (attributes ws, no 
image). 

aggregate _section_ statement 
2:= ( <section statement>>”0 } 
| group descr 
| if statement 
| section creation statement 


:= group <group name>0|l 
<( group specs )>°|!1 
section statement 


group descr 


e No two groups for an address space can have the same 
group name. 


group spec <, group spec >>70 


group specs : 


group_alignment 
attributes 
group_load_address 
fill <= fill values>0l!l 
group_page 
group_run_address 
group_type 
allow_cross_references 


group_spec 
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e The allow-cross-references property is only allowed for 


overlay groups. 


e Sub groups inherit all properties from a parent group. 


group alignment 235 
attributes 235 


group_load_address 


fill spec 235 


fill_values 235 


group_page 235 


group run address 
group type 


align = expr 


attributes = <attribute>?=1 


load_addr <= load_or_run_addr>°|1 
fill = fill_values 


expr 
[ expr <, expr>?=9 ] 


page <= expr>0|1 
run_addr <= load or run addr>0|! 


clustered 
contiguous 
ordered 
overlay 


e For non-contiguous groups, you can only specify 
group alignment and attributes. 


e The overlay keyword also sets the contiguous property. 


e The clustered property cannot be set together with contiguous 
or ordered on a single group. 


attribute = 
| 
| 
| 
| 
| 
load or run addr ::= 


addr absolute 235 


// readable sections 

// writable sections 
executable code sections 
// initialized sections 

// scratch sections 

// blanked (cleared) sections 


ONE xX SH 
SS. 
N 


addr_absolute 
addr range <| addr_range>?=° 


expr 
memory_reference [ expr ] 


e An absolute address can only be set on ordered groups. 


addr_ range 


[ expr .. expr ] 
memory reference 
memory reference [ expr .. expr ] 
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* The parent of a group with an addr_range or page restriction 
cannot be ordered, contiguous or clustered. 


memory reference ::= mem : <proc name :>0|1 
<core name :>°|1 mem name 


e A proc name refers to a defined processor. 


e Â core_name refers to a defined core. 


e A mem_name refers to a defined memory. 


if_statement ::= if ( expr ) section statement 
<else section statement>9ll 


section creation statement 
::= section section name 
( <section spec>0|l ) 
(<select section statement ;>>70 ) 


attributes 


| fill spec 
| size = expr 


section spec $2 


8.4 EXPRESSION EVALUATION 


Only constant expressions are allowed, including sizes, but not addresses, 
of sections in object files. 


All expressions are evaluated with 64-bit precision integer arithmetic. The 
result of an expression can be absolute or relocatable. A symbol you 
assign is created as an absolute symbol. 
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8.5 SEMANTICS OF THE ARCHITECTURE DEFINITION 


Keywords in the architecture definition 


architecture 
extends 
endianness 
bus 
mau 
width 
map 
space 
id 
mau 
align 
page size 
stack 
min size 
grows 
align 
fixed 
heap 
min size 
grows 
align 
fixed 
copytable 
align 
copy unit 
dest 
start address 
run addr 
symbol 
map 


big little 


low_to_high 


low_to_high 


map 
dest 
dest_dbits 
dest_offset 
size 
src_dbits 
src offset 


bus space 


high to low 


high to low 
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8.5.1 DEFINING AN ARCHITECTURE 


With the keyword architecture you define an architecture and assign a 
unique name to it. The name is used to refer to it at other places in the 


LSL file: 
architecture name 
{ 
definitions 
} 


If you are defining multiple core architectures that show great 
resemblance, you can define the common features in a parent core 
architecture and extend this with a child core architecture that contains 
specific features. The child inherits all features of the parent. With the 
keyword extends you create a child core architecture: 


architecture name_child_arch extends name_parent_arch 


{ 


definitions 


} 


A core architecture can have any number of parameters. These are 
identifiers which get values assigned on instantiation or extension of the 
architecture. You can use them in any expression within the core 
architecture. Parameters can have default values, which are used when the 
core architecture is instantiated with less arguments than there are 
parameters defined for it. When you extend a core architecture you can 
pass arguments to the parent architecture. Arguments are expressions that 
set the value of the parameters of the sub-architecture. 


architecture name child arch (parml,parm2-1) 
extends name parent arch (arguments) 


{ 


definitions 
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8.5.2 DEFINING INTERNAL BUSES 


With the bus keyword you define a bus (the combination of data and 
corresponding address bus). The bus name is used to identify a bus and 
does not conflict with other identifiers. Bus descriptions in an architecture 
definition or derivative definition define internal buses. Some internal 
buses are used to communicate with the components outside the core or 
processor. Such buses on a processor have physical pins reserved for the 
number of bits specified with the width statements. 


The mau field specifies the MAU size (Minimum Addressable Unit) of 
the data bus. This field is required. 


The width field specifies the width (number of address lines) of the 
data bus. The default value is the MAU size. 


The map keyword specifies how this bus maps onto another bus (if so). 
Mappings are described in section 8.5.4, Mappings. 


bus bus_name 


{ 

mau = 8; 

width = 8; 

map ( map description ); 
} 


8.5.3 DEFINING ADDRESS SPACES 


With the space keyword you define a logical address space. The space 
name is used to identify the address space and does not conflict with other 
identifiers. 


The id field defines how the addressing space is identified in object 
files. In general, each address space has a unique ID. The linker locates 
sections with a certain ID in the address space with the same ID. This 
field is required. In IEEE this ID is specified explicitly for sections and 
symbols, ELF sections map by default to the address space with ID 1. 
Sections with one of the special names defined in the ABI (Application 
Binary Interface) may map to different address spaces. 

The mau field specifies the MAU size (Minimum Addressable Unit) of 
the space. This field is required. 

The align value must be a power of two. The linker uses this value to 
compute the start addresses when sections are concatenated. An align 
value of n means that objects in the address space have to be aligned 
on n MAUs. 
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The page_size field sets the page size in MAUs for the address space. 
It must be a power of 2. The default page size is 1. See also the page 
keyword in subsection Locating a group in section 8.8.2, Creating and 
Locating Groups of Sections. 

The map keyword specifies how this address space maps onto an 
internal bus or onto another address space. Mappings are described in 
section 8.5.4, Mappings. 


Stacks and beaps 


The stack keyword defines a stack in the address space and assigns a 
name to it. The architecture definition must contain at least one stack 
definition. Each stack of a core architecture must have a unigue name. 
See also the stack keyword in section 8.8.3, Creating or Modifying 
Special Sections. 


The stack is described in terms of a minimum size (min_size) and the 
direction in which the stack grows (grows). This can be either from 
low_to_high addresses (stack grows upwards, this is the default) or 
from high_to_low addresses (stack grows downwards). The 

min size is required. 


By default, the linker tries to maximize the size of the stacks and heaps. 
After locating all sections, the largest remaining gap in the space is 
used completely for the stacks and heaps. If you specify the keyword 
fixed, you can disable this so-called 'balloon behavior’. The size is 
also fixed if you used a stack or heap in the software layout definition 
in a restricted way. For example when you override a stack with 
another size or select a stack in an ordered group with other sections. 


Optionally you can specify an alignment for the stack with the 
argument align. This alignment must be egual or larger than the 
alignment that you specify for the address space itself. 


The heap keyword defines a heap in the address space and assigns a 
name to it. The definition of a heap is similar to the definition of a 
stack. See also the heap keyword in section 8.8.3, Creating or 
Modifying Special Sections. 


See section 8.8, Semantics of the Section Layout Definition for 
information on creating and placing stack sections. 
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Copy tables 


The copytable keyword defines a copy table in the address space. 
The content of the copy table is created by the linker and contains the 
start address and size of all sections that should be initialized by the 
startup code. If the architecture definition contains more than one 
address space, you must define exactly one copy table in one of the 
address spaces. If the architecture definition contains only one address 
space, the copy table definition is optional. 


Optionally you can specify an alignment for the copy table with the 
argument align. This alignment must be egual or larger than the 
alignment that you specify for the address space itself. If smaller, the 
alignment for the address space is used. 


The copy_unit argument specifies the size in MAUs of information 
chunks that are copied. If you do not specify the copy unit, the MAU 
size of the address space itself is used. 


The dest argument specifies the destination address space that the 
code uses for the copy table. The linker uses this information to 
generate the correct addresses in the copy table. The memory into 
where the sections must be copied at run-time, must be accessible 
from this destination space. 


Start address 


The start_address keyword specifies the start address for the 
position where the C startup code is located. When a processor is reset, 
it initializes its program counter to a certain start address, sometimes 
called the reset vector. In the architecture definition, you must specify 
this start address in the correct address space in combination with the 
name of the label in the application code which must be located here. 


The run_addr argument specifies the start address (reset vector). If the 
core starts executing using an entry from a vector table, and directly 
jumps to the start label, you should omit this argument. 


The symbol argument specifies the name of the label in the 
application code that should be located at the specified start address. 
The symbol argument is reguired. The linker will resolve the start 
symbol and use its value after locating for the start address field in 
IEEE-695 files and Intel Hex files. If you also specified the run_addr 
argument, the start symbol (label) must point to a section. The linker 
locates this section such that the start symbol ends up on the start 
address. 
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space space name 


{ 
id = 1; 
mau = 8; 
align = 8; 
page_size = 1; 
stack name (min_size = 1k, grows = low_to_high); 
start_address ( run_addr = 0x0000, 
symbol = "start label" ) 
map ( map description ); 
} 


8.5.4 MAPPINGS 


You can use a mapping when you define a space, bus or memory. With 
the map field you specify how addresses from the source (space, bus or 
memory) are translated to addresses of a destination (space, bus). The 
following mappings are possible: 


e space => space 
e space => bus 
e bus => bus 


e memory => bus 


With a mapping you specify a range of source addresses you want to map 
(specified by a source offset and a size), the destination to which you 
want to map them (a bus or another address space), and the offset address 
in the destination. 


e The dest argument specifies the destination. This can be a bus or 
another address space (only for a space to space mapping). This 
argument is required. 


e The src_offset argument specifies the offset of the source addresses. 
In combination with size, this specifies the range of address that are 
mapped. By default the source offset is 0x0000. 

e The size argument specifies the number of addresses that are 
mapped. This argument is required. 

e The dest_offset argument specifies the position in the destination to 
which the specified range of addresses is mapped. By default the 
destination offset is 0x0000. 
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If you are mapping a bus to another bus, the number of data lines of each 
bus may differ. In this case you have to specify a range of source data 
lines you want to map (src_dbits = begin..end) and the range of 
destination data lines you want to map them to (dest_dbits = 
first..last). 


e The src_dbits argument specifies a range of data lines of the source 
bus. By default all data lines are mapped. 


* The dest_dbits argument specifies a range of data lines of the 
destination bus. By default, all data lines from the source bus are 
mapped on the data lines of the destination bus (starting with line 0). 


From space to space 


If you map an address space to another address space (nesting), you can 
do this by mapping the subspace to the containing larger space. In this 
example a small space of 64k is mapped on a large space of 16M. 


space small 


{ 
id = 2; 
mau = 4; 
map (src_offset = 0, dest_offset = 0, 
dest = space : large, size = 64k); 
} 


From space to bus 


All spaces that are not mapped to another space must map to a bus in the 
architecture: 


space large 


{ 
id = 1; 
mau = 4; 
map (src_offset = 0, dest_offset = 0, 
dest = bus:bus name, size = 16M ); 
} 


From bus to bus 


The next example maps an external bus called e_bus to an internal bus 
called i_bus. This internal bus resides on a core called mycore. The 
source bus has 16 data lines whereas the destination bus has only 8 data 
lines. Therefore, the keywords src_dbits and dest_dbits specify 
which source data lines are mapped on which destination data lines. 
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architecture mycore 


l bus i_bus 
{ 
mau = 4; 
} 
space i_space 
i map (dest=bus:i_bus, size=256); 
} 
} 
bus e_bus 
{ 
mau = 16; 
width = 16; 
map (dest = bus:mycore:i_bus, 
src_dbits = 0..7, dest_dbits = 0..7 ) 
} 


& It is not possible to map an internal bus to an external bus. 
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8.6_ SEMANTICS OF THE DERIVATIVE DEFINITION 


Keywords in the derivative definition 


derivative 
extends 
core 
architecture 
bus 
mau 
width 
map 
memory 
type reserved rom ram 
mau 
size 
speed 
map 


map 
dest bus space 
dest dbits 
dest offset 
size 
src dbits 
src offset 


8.6.1 DEFINING A DERIVATIVE 


nvram 


With the keyword derivative you define a derivative and assign a 
unigue name to it. The name is used to refer to it at other places in the 


LSL file: 


derivative name 


{ 


definitions 


} 
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If you are defining multiple derivatives that show great resemblance, you 
can define the common features in a parent derivative and extend this 
with a child derivative that contains specific features. The child inherits all 
features of the parent (cores and memories). With the Keyword extends 
you create a child derivative: 


derivative name child deriv extends name parent deriv 


{ 


definitions 


y 


As with a core architecture, a derivative can have any number of 
paramcters. These are identifiers which get values assigned on 
instantiation or extension of the derivative. You can use them in any 
expression within the derivative definition. 


derivative name child deriv (parml,parm2-1) 
extends name parent derivh (arguments) 


{ 


definitions 


8.6.2 INSTANTIATING CORE ARCHITECTURES 


With the keyword core you instantiate a core architecture in a derivative. 


e With the keyword architecture you tell the linker that the given 
core has a certain architecture. The architecture name refers to an 
existing architecture definition in the same LSL file. 


For example, if you have two cores (called mycore_1 and mycore_2) 
that have the same architecture (called mycorearch), you must 
instantiate both cores as follows: 


core mycore 1 


{ 
architecture = mycorearch; 
} 
core mycore 2 
{ 
architecture = mycorearch; 
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If the architecture definition has parameters you must specify the 
arguments that correspond with the parameters. For example 
mycorearch1 expects two parameters which are used in the 
architecture definition: 


core mycore 


{ 


architecture = mycorearchl (1,2); 


} 


8.6.3 DEFINING INTERNAL MEMORY AND BUSES 


With the memory keyword you define physical memory that is present on 
the target board. The memory name is used to identify the memory and 
does not conflict with other identifiers. It is common to define internal 
memory (on-chip) in the derivative definition. External memory (off-chip 
memory) is usually defined in the board specification (See section 8.7.3, 
Defining External Memory and Buses). 


The type field specifies a memory type: 
- rom: read only memory 
- ram: random access memory 


— nvram non volatile ram 


The optional reserved qualifier before the memory type, tells the 
linker not to locate any section in the memory by default. You can 
locate sections in such memories using an absolute address or range 
restriction (see subsection Locating a group in section 8.8.2, Creating 
and Locating Groups of Sections). 


The mau field specifies the MAU size (Minimum Addressable Unit) of 
the memory. This field is required. 


The size field specifies the size in MAU of the memory. This field is 
required. 


The speed field specifies a symbolic speed for the memory (0..4): 0 is 
the fastest, 4 the slowest. The linker uses the relative speed of the 
memories in such a way, that optimal speed is achieved. The default 
speed is 1. 


The map field specifies how this memory maps onto an (internal) bus. 
Mappings are described in section 8.5.4, Mappings. 
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memory mem name 


{ 

type = rom; 

mau = 8; 

size = 64k; 

speed = 2; 

map ( map description ); 
} 


With the bus keyword you define a bus in a derivative definition. Buses 
are described in section 8.5.2, Defining Internal Buses. 
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8.7 SEMANTICS OF THE BOARD SPECIFICATION 


Keywords in the board specification 


processor 
derivative 
bus 
mau 
width 
map 
memory 
type reserved rom ram nvram 
mau 
size 
speed 
map 


map 
dest bus space 
dest_dbits 
dest_offset 
size 
src_dbits 
src offset 


8.7.1 DEFINING A PROCESSOR 


& 


If you have a target board with multiple processors that have the same 
derivative, you need to instantiate each individual processor in a processor 
definition. This information tells the linker which processor has which 
derivative and enables the linker to distinguish between the present 
processors. 


If you use processors that all have a unigue derivative, you may omit the 
processor definitions. In this case the linker assumes that for each 
derivative definition in the LSL file there is one processor. The linker uses 
the derivative name also for the processor. 
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With the keyword processor you define a processor. You can freely 
choose the processor name. The name is used to refer to it at other places 
in the LSL file: 


processor proc_ name 


{ 


processor definition 


} 


8.7.2 INSTANTIATING DERIVATIVES 


With the keyword derivative you tell the linker that the given processor 
has a certain derivative. The derivative name refers to an existing 
derivative definition in the same LSL file. 


For examples, if you have two processors on your target board (called 
myproc_1 and myproc_2) that have the same derivative (called 
myderiv), you must instantiate both processors as follows: 


processor myproc_1 


{ 

derivative = myderiv; 
} 
processor myproc_2 
{ 

derivative = myderiv; 
} 


If the derivative definition has parameters you must specify the 
arguments that correspond with the parameters. For example 
myderiv1 expects two parameters which are used in the derivative 
definition: 


processor myproc 


{ 
derivative = myderivl (2,4); 


} 


Linker Script Language 


8.7.3 DEFINING EXTERNAL MEMORY AND BUSES 


db 


db 


It is common to define external memory (off-chip) and external buses at 
the global scope (outside any enclosing definition). Internal memory 
(on-chip memory) is usually defined in the scope of a derivative 
definition. 


With the keyword memory you define physical memory that is present on 
the target board. The memory name is used to identify the memory and 
does not conflict with other identifiers. If you define memory parts in the 
LSL file, only the memory defined in these parts is used for placing 
sections. 


If no external memory is defined in the LSL file and if the linker option to 
allocate memory on demand is set then the linker will assume that all 
virtual addresses are mapped on physical memory. You can override this 
behavior by specifying one or more memory definitions. 


memory mem_name 


{ 

type = rom; 

mau = 8; 

size = 64k; 

speed = 2; 

map ( map description ); 
) 


For a description of the keywords, see section 8.6.3, Defining Internal 
Memory and Buses. 


With the keyword bus you define a bus (the combination of data and 
corresponding address bus). The bus name is used to identify a bus and 
does not conflict with other identifiers. Bus descriptions at the global 
scope (outside any definition) define external buses. These are buses that 
are present on the target board. 


bus bus_ name 


{ 

mau = 8; 

width = 8; 

map ( map description ); 
} 


For a description of the keywords, see section 8.5.2, Defining Internal 
Buses. 
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You can connect off-chip memory to any derivative: you need to map the 
off-chip memory to a bus and map that bus on the internal bus of the 
derivative you want to connect it to. 
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8.8 SEMANTICS OF THE SECTION LAYOUT DEFINITION 


Keywords in the section layout definition 


section layout 
direction low_to_high high to low 
group 
align 
attributes +- rwxbis 
fill 
ordered 
clustered 
contiguous 
overlay 
allow cross references 
load addr 
mem 
run _addr 
mem 
page 
select 
heap 
size 
stack 
size 
reserved 
size 
attributes rwx 
fill 
alloc allowed absolute 
copytable 
section 
size 
attributes rwx 
fill 


if 
else 
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8.8.1 DEFINING A SECTION LAYOUT 


With the keyword section_layout you define a section layout for 
exactly one address space. In the section layout you can specify how input 
sections are placed in the address space, relative to each other, and what 
the absolute run and load addresses of each section will be. 


You can define one or more section definitions. Each section definition 
arranges the sections in one address space. You can precede the address 
space name with a processor name and/or core name, separated by 
colons. You can omit the processor name and/or the core name if only 
one processor is defined and/or only one core is present in the processor. 
A reference to a space in the only core of the only processor in the system 
would look like ”: :my_ space”. A reference to a space of the only core 
on a specific processor in the system could be "my chip: :my_space”. 
The next example shows a section definition for sections in the my_ space 
address space of the processor called my_chip: 


section layout my chip::my space ( locate direction ) 


{ 


section statements 


} 


With the optional keyword direction you specify whether the linker 
starts locating sections from low_to_high (default) or from 
high_to_low. In the second case the linker starts locating sections at the 
highest addresses in the address space but preserves the order of sections 
when necessary (one processor and core in this example). 


section_layout ::my_space ( direction = high_to_low ) 
{ 


section statements 


If you do not explicitly tell the linker how to locate a section, the linker 
decides on the basis of the section attributes in the object file and the 
information in the architecture definition and memory parts where to 
locate the section. 


Linker Script Language 8-39 


8.8.2 CREATING AND LOCATING GROUPS OF 
SECTIONS 


Sections are located per group. A group can contain one or more (sets of) 
input sections as well as other groups. Per group you can assign a mutual 
order to the sets of sections and locate them into a specific memory part. 


group ( group specifications ) 


{ 


section_statements 


} 


With the section_statements you generally select sets of sections to form 
the group. This is described in subsection Selecting sections for a group. 


Instead of selecting sections, you can also modify special sections like 
stack and heap or create a reserved section. This is described in section 
8.8.3, Creating or Modifying Special Sections. 


With the group_specifications you actually locate the sections in the group. 
This is described in subsection Locating a group. 


Selecting sections for a group 


With the select keyword you can select one or more sections for the 
group. You can select a section by name or by attributes. If you select a 
section by name, you can use a wildcard pattern: 


Dg 


matches with all section names 


Eoy matches with a single character in the section name 
Na takes the next character literally 

*[abc]” matches with a single 'a', 'b' or 'c' character 

”[a—z]” matches with any single character in the range 'a' to ’z’ 


group ( ... ) 

{ 
select "mysection”; 
select "*"; 


} 


The first select statement selects the section with the name "mysection”. 
The second select statement selects all sections that were not selected 
yet. 
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A section is selected by the first select statement that matches, in the 
union of all section layouts for the address space. Global section layouts 
are processed in the order in which they appear in the LSL file. Internal 
core architecture section layouts always take precedence over global 
section layouts. 


e The attributes field selects all sections that carry (or do not carry) 
the given attribute. With +attribute you select sections that have the 
specified attribute set. With -attribute you select sections that do not 
have the specified attribute set. You can specify one or more of the 
following attributes: 

- r readable sections 

- w writable sections 

- x executable sections 
initialized sections 


sections that should be cleared at program startup 


O 


scratch sections (not cleared and not initialized) 


To select all read-only sections: 


group ( ... ) 
{ 


select (attributes = +r-w); 


& Keep in mind that all section selections are restricted to the address space 
of the section layout in which this group definition occurs. 


Locating a group 


group group name ( group specifications ) 


{ 


section_statements 


} 


With the group_specifications you actually define how the linker must 
locate the group. You can roughly define three things: 1) assign properties 
to the group like alignment and read/write attributes, 2) define the mutual 
order in the address space for sections in the group and 3) restrict the 
possible addresses for the sections in a group. 
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The linker creates labels that allow you to refer to the begin and end 
address of a group from within the application software. Labels 

_lc_gb_ group name and _lc_ge_group name mark the begin and end 
of the group respectively, where the begin is the lowest address used 
within this group and the end is the highest address used. Notice that a 
group not necessarily occupies all memory between begin and end 
address. The given label refers to where the section is located at run-time 
(versus load-time). 


1. Assign properties to the group like alignment and read/write attributes. 
These properties are assigned to all sections in the group (and subgroups) 
and override the attributes of the input sections. 


e The align field tells the linker to align all sections in the group and 
the group as a whole according to the align value. By default the linker 
uses the largest alignment constraint of either the input sections or the 
alignment of the address space. 


e The attributes field tells the linker to assign one or more attributes 
to all sections in the group. This overrules the default attributes. By 
default the linker uses the attributes of the input sections. You can set 
the r, w, or rw attributes and you can switch between the b and s 
attributes. 


2. Define the mutual order of the sections in the group. 
By default, a group is unrestricted which means that the linker has total 
freedom to place the sections of the group in the address space. 


e The ordered keyword tells the linker to locate the sections in the 
same order in the address space as they appear in the group (but not 
necessarily adjacent). 


Suppose you have an ordered group that contains the sections ’A’, ’B’ 
and ’C’. By default the linker places the sections in the address space 
like 'A' — 'B' — °C’, where section ’A’ gets the lowest possible address. 
With direction=high_to_low in the section_layout space 
properties, the linker places the sections in the address space like ’C’ — 
'B' — 'A', where section 'A' gets the highest possible address. 


* The contiguous kcyword tells the linker to locate the sections in the 
group in a single address range. Within a contiguous group the input 
sections are located in arbitrary order, however the group occupies one 
contigous range of memory. Due to alignment of sections there can be 
'alignment gaps' between the sections. 
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When you define a group that is both ordered and contiguous, this 
is called a sequential group. In a sequential group the linker places 
sections in the same order in the address space as they appear in the 
group and it occupies a contiguous range of memory. 


The clustered keyword tells the linker to locate the sections in the 
group in a number of contiguous blocks. It tries to keep the number of 
these blocks to a minimum. If enough memory is available, the group 
will be located as if it was specified as contiguous. Otherwise, it gets 
split into two or more blocks. 


If a contiguous or clustered group contains alignment gaps, the linker 
can locate sections that are not part of the group in these gaps. To 
prevent this, you can use the fill keyword. If the group is located in 
RAM, the gaps are treated as reserved (scratch) space. If the group is 
located in ROM, the alignment gaps are filled with zeros by default. 
You can however change the fill pattern by specifying a bit pattern. 
The result of the expression, or list of expressions, is used as values to 
write to memory, each in MAU. 


The overlay keyword tells the linker to overlay the sections in the 
group. The linker places all sections in the address space using a 
contiguous range of addresses. (Thus an overlay group is automatically 
also a contiguous group.) To overlay the sections, all sections in the 
overlay group share the same run-time address. 


For each input section within the overlay the linker automatically 
defines two symbols. The symbol _le_cb_section_name is defined 
as the load-time start address of the section. The symbol 
_lc_ce_section name is defined as the load-time end address of 
the section. C (or assembly) code may be used to copy the overlaid 
sections. 


If sections in the overlay group contain references between groups, the 
linker reports an error. The keyword allow_cross_references tells 
the linker to accept cross-references. Normally, it does not make sense 
to have references between sections that are overlaid. 
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group ovl (overlay) 


{ 
group a 
{ 
select "my ovl_ pl”; 
select "my ovl_p2”; 
} 
group b 
{ 
select “my ovl gl”; 
} 
} 


It may be possible that one of the sections in the overlay group already 
has been defined in another group where it received a load-time 
address. In this case the linker does not overrule this load-time address 
and excludes the section from the overlay group. 


3. Restrict the possible addresses for the sections in a group. 
The load-time address specifies where the group's elements are loaded in 
memory at download time. The run-time address specifies where sections 
are located at run-time, that is when the program is executing. If you do 
not explicitly restrict the address in the LSL file, the linker assigns 
addresses to the sections based on the restrictions relative to other sections 
in the LSL file and section alignments. The program is responsible for 
copying overlay sections at appropriate moment from its load—time 
location to its run-time location (this is typically done by the startup 
code). 


The run_addr keyword defines the run-time address. If the run-time 
location of a group is set explicitly, the given order between groups 
specify whether the run-time address propagates to the parent group 
or not. The location of the sections a group can be restricted either to a 
single absolute address, or to a number of address ranges. With an 
expression you can specify that the group should be located at the 
absolute address specified by the expression: 


group (run_addr = 0xa00f0000) 


You can use the ’[offset]’ variant to locate the group at the given 
absolute offset in memory: 


group (run_addr = mem:A[0x1000] ) 
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A range can be an absolute space address range, written as [ expr .. 
expr ],a complete memory device, written as mem:mem name, or a 
memory address range, mem:mem name[ expr .. expr ] 


group (run addr = mem:my dram) 


You can use the ’|’ to specify an address range of more than one 
physical memory device: 


group (run addr = mem:A | mem:B) 


e The load_addr keyword changes the meaning of the section selection 
in the group: the linker selects the load-time ROM copy of the named 
section(s) instead of the regular sections. Just like run_addr you can 
specify an absolute address or an address range. 


The load_addr keyword itself (without an assignment) specifies that 
the group's position in the LSL file defines its load-time address. 


group (load addr) 
select "mydata”; // select ROM copy of mydata: 
// "[mydata]” 


The load-time and run-time addresses of a group cannot be set at the 
same time. If the load-time property is set for a group, the group (only) 
restricts the positioning at load-time of the group's sections. It is not 
possible to set the address of a group that has a not—unrestricted parent 
group. 


The properties of the load-time and run-time start address are: 


e At run-time, before using an element in an overlay group, the 
application copies the sections from their load location to their 
run-time location, but only if these two addresses are different. For 
non-overlay sections this happens at program start-up. 


e The start addresses cannot be set to absolute values for unrestricted 
groups. 

e For non-overlay groups that do not have an overlay parent, the 
load-time start address equals the run-time start address. 


e For any group, if the run-time start address is not set, the linker 
selects an appropriate address. 


For overlays, the linker reserves memory at the run-time start address as 
large as the largest element in the overlay group. 
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The page keyword tells the linker to place the group in one page. 
Instead of specifying a run-time address, you can specify a page and 
optional a page number. Page numbers start from zero. If you omit the 
page number, the linker chooses a page. 


The page keyword refers to pages in the address space as defined in 
the architecture definition. See also the page_size keyword in section 
8.5.3, Defining Address Spaces. 


group (page, ... ) 
group (page = 3, ...) 


8.8.3 CREATING OR MODIFYING SPECIAL SECTIONS 


Instead of selecting sections, you can also create a reserved section or an 
output section or modify special sections like a stack or a heap. Because 
you cannot define these sections in the input files, you must use the linker 
to create them. 


Stack 


The stack keyword tells the linker to reserve memory for the stack. 
The name for the stack section refers to the stack as defined in the 
architecture definition. If no name was specified in the architecture 
definition, the default name is stack. 


With the keyword size you can specify the size for the stack. If the 
size is not specified, the linker uses the size given by the min_size 
argument as defined for the stack in the architecture definition. 
Normally the linker automatically tries to maximize the size, unless you 
specified the fixed keyword. 


group ( ... ) 
{ 
stack "mystack” ( size = 2k ); 


} 


The linker creates two labels to mark the begin and end of the stack, 
_lc_ub stack name for the begin of the stack and 
_lc_ue_stack_ name for the end of the stack. The linker allocates 
space for the stack when there is a reference to either of the labels. 


See also the stack keyword in section 8.5.3, Defining Address Spaces. 
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The heap keyword tells the linker to reserve a dynamic memory range 
for the malloc() function. Optionally you can assign a name to the 
heap section. With the keyword size you can change the size for the 
heap. If the size is not specified, the linker uses the size given by the 
min_size argument as defined for the heap in the architecture 
definition. Normally the linker automatically tries to maximize the size, 
unless you specified the fixed keyword. 


group ( ... ) 
{ 

heap "“myheap” ( size = 2k ); 
} 


The linker creates two labels to mark the begin and end of the heap, 
_lc_ub heap name for the begin of the heap and 

_lc_ue_ heap name for the end of the heap. The linker allocates 
space for the heap when a reference to either of the section labels 
exists in one of the input object files. 


Reserved section 


The reserved keyword tells the linker to create an area or section of 
a given size. The linker will not locate any other sections in the 
memory occupied by a reserved section, with some exceptions. 
Optionally you can assign a name to a reserved section. With the 
keyword size you can specify a size for a given reserved area or 
section. 


group ( ... ) 
{ 


reserved "myreserved” ( size = 2k ); 


} 


The optional £111 field contains a bit pattern that the linker writes to 
all memory addresses that remain unoccupied during the locate 
process. The result of the expression, or list of expressions, is used as 
values to write to memory, each in MAU. The first MAU of the fill 
pattern is always the first MAU in the section. 


By default, no sections can overlap with a reserved section. With 
alloc_allowed=absolute sections that are located at an absolute 
address due to an absolute group restriction can overlap a reserved 
section. 
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With the attributes field you can set the access type of the reserved 
section. The linker locates the reserved section in its space with the 
restrictions that follow from the used attributes, r, w or x or a valid 
combination of them. The allowed attributes are shown in the 
following table. A value between < and > in the table means this value 
is set automatically by the linker. 


Properties set in LSL Resulting section properties 

attributes filled access memory content 

x yes <rom> executable 
r yes r <rom> data 

r no r <rom> scratch 

rx yes r <rom> executable 
rw yes rw <ram> data 

rw no rw <ram> scratch 
rwx yes rw <ram> executable 


group ( ... ) 
{ 
reserved "myreserved” ( size = 2k, 
attributes = rw, fill = Oxaa ); 


} 


If you do not specify any attributes, the linker will reserve the given 
number of maus, no matter what type of memory lies beneath. If you 
do not specify a fill pattern, no section is generated. 


The linker creates two labels to mark the begin and end of the section, 
_lc_ub name for the start, and _lc_ue_name for the end of the 
reserved section. 


Output sections 


The section keyword tells the linker to accumulate sections obtained 
from object files (“input sections”) into an output section of a fixed size 
in the locate phase. You can select the input sections with select 
statements. With the keyword size you specify the size of the output 
section. 
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The fill field contains a bit pattern that the linker writes to all unused 
space in the output section. When all input sections have an image 
(code/data) you must specify a fill pattern. If you do not specify a fill 
pattern, all input sections must be scratch sections. The fill pattern is 
aligned at the start of the output section. 


As with a reserved section you can use the attributes field to set the 
access type of the output section. 


group ( ... ) 


{ 
section “myoutput” ( size = 4k, attributes = rw, 
fill = Oxaa ) 
{ 
select "myinput1"”; 
select "myinput2"; 
} 
} 


The linker creates two labels to mark the begin and end of the section, 
_lc_ub name for the start, and _lc_ue_name for the end of the 
output section. 


Copy table 


The copytable keyword tells the linker to select a section that is used 
as copy-table. The content of the copy-table is created by the linker. It 
contains the start address and length of all sections that should be 
initialized by the startup code. 


The linker creates two labels to mark the begin and end of the section, 
_lc_ub table for the start, and _lc_ue_table for the end of the 
copy table. The linker generates a copy table when a reference to 
either of the section labels exists in one of the input object files. 


8.8.4 CREATING SYMBOLS 


You can tell the linker to create symbols before locating by putting 
assignments in the section layout definition. Symbol names are 
represented by double-guoted strings. Any string is allowed, but object 
files may not support all characters for symbol names. You can use two 
different assignment operators. With the simple assignment operator =’, 
the symbol is created unconditionally. With the ’:=’ operator, the symbol is 
only created if it already exists as an undefined reference in an object file. 
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The expression that represents the value to assign to the symbol may 


contain references to other symbols. If such a referred symbol is a special 


section symbol, creation of the symbol in the left hand side of the 
assignment will cause creation of the special section. 


section layout 


{ 
" lc bs” := “ lc ub stack”; 
// when the symbol _lc_ bs occurs as an undefined 
// reference in an object file, 
// the linker allocates space for the stack 
} 


8.8.5 CONDITIONAL GROUP STATEMENTS 


Within a group, you can conditionally select sections or create special 
sections. 


With the if keyword you can specify a condition. The succeeding 
section statement is executed if the condition evaluates to TRUE (1). 


The optional else keyword is followed by a section statement which 
is executed in case the if-condition evaluates to FALSE (0). 


group ( ... ) 
{ 
if ( exists( "mysection” ) ) 
select "mysection”; 
else 
reserved "myreserved” ( size=2k ); 
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CPU FUNCTIONAL 
PROBLEMS 


ail TASKING M 


diLdVHO 


CPU Functional Problems 


9.1 INTRODUCTION 


Infineon Technologies regularly publishes microcontroller errata sheets 
reporting functional problems and deviations from the electrical 
specifications and timing specifications. 


The TASKING TriCore software development tools provide solutions for a 
number of these functional problems in the TriCore architecture. 


Support to deal with CPU functional problem is provided in three areas: 


e Whenever possible and relevant, compiler bypasses will modify the 
code in order to avoid the identified erroneous code sequences; 


e The TriCore assembler gives warnings for suspicious or erroneous code 
sequences; 


e Ready-built, 'protected' standard C libraries with bypasses for all 
identified TriCore CPU functional problems are included in the 
toolchain. 


This chapters lists a summary of identified functional problems which can 
be bypassed by the TASKING TriCore tool kit. 


Please refer to the Infineon errata sheets for the TriCore architecture 
revision-step of your particular device, to check the need for applying any 
of these bypasses. Also refer to the Infineon errata sheets for a complete 
description of the CPU functional problems, as the workarounds listed 
below do not describe the functional problem itself. 


With the TASKING C compiler and assembler command line options, 
pragmas and macro definitions you can enable or disable specific CPU 
functional problem bypasses. 


To enable all compiler bypasses and assembler checks for a specific 
TriCore derivative at once, for example for the TC11IB, use the command 
line option —-silicon-bug=all-tc11ib. 


To enable the bypasses from the embedded development environment 


(EDE): 
1. From the Projects menu select Project Options... 
2. Expand the Processor entry. 


3. Select Bypasses. This shows the bypasses for the target processor you 
have selected. 
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4. Enable one or more bypasses, or select All bypasses TCxxx 


9.2 CPU FUNCTIONAL PROBLEM BYPASSES 


CPU TC.013 


Compiler and assembler option: 
—-silicon-bug-cpu-tc013 


Assembler control: 
$CPU_TC013 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC013__ is defined if you specify option 
—-silicon-bug-cpu-tc013. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates a NOP16 
instruction if a 16-bit load/store address register instruction (instructions: 
LD16.A en ST16.A) is followed by a lower context load/store instruction 
(instructions: LDLCX and STLCX). 


Assembler check: 


The assembler gives a warning if a 16-bit load/store address register 
instruction (instructions: LD16.A en ST16.A) is followed by a lower context 
load/store instruction (instructions: LDLCX and STLCX). 


Wnum: suspicious instruction concerning CPU functional 
defect TC013 


You can suppress this warning with the option -wnum. 
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CPU TC.018 


Compiler and assembler option: 
—-silicon-bug-cpu-tc018 


Assembler control: 
$CPU_TCO18 (on | off) 


Assembler macro: 


The assembler macro __ CPU_TC018__ is defined if you specify option 
—-silicon-bug-cpu-tc018. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates an 
ISYNC instruction before each LOOP, LOOP16 and LOOPU instruction. 


Assembler check: 


The assembler gives a warning when the preceding instruction of a LOOP, 
LOOP16 or LOOPU instruction is not an ISYNC instruction: 


Wnum: suspicious instruction concerning CPU functional 
defect TC018 


You can suppress this warning with the option -wnum. 
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CPU TC.021 


Compiler and assembler option: 
--silicon-bug=cpu-tc021 


Assembler control: 


$CPU_TCO021 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC021__ is defined if you specify option 
—-silicon-bug=cpu-tc021. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates a NOP 
instruction between a (target) label and the instruction following it This is 
done when the instruction directly uses an An register for either an 
effective address calculation or as the target of an indirect branch. 
Optionally an integer instruction may directly follow the label. 


For example, a NOP will be inserted after the following labels: 


A_label: 
ji a4 

B label: 
add do, dl ; integer instruction 
ji a4 


Assembler check: 


The assembler gives a warning for an instruction using an An register for 
either an effective address calculation or as the target of an indirect branch 
that is located directly after a (target) label, optionally with an integer 
instruction in between: 


Wnum: suspicious instruction concerning CPU functional 
defect TC021 


You can suppress this warning with the option -wnum. 
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CPU TC.023 


Assembler option: 
—-silicon-bug-cpu-tc023 


Assembler control: 
$CPU_TC023 (on | off) 


Assembler macro: 


The assembler macro __ CPU_TC023__ is defined if you specify option 
—-silicon-bug-cpu-tc023. 


Compiler bypass: 


There is no C compiler workaround reguired for this CPU functional 
problem, because the compiler does not generate CALLI instructions with 
a target address in register A11. 


Assembler check: 


The assembler generates an error for instruction CALLI A11. 
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CPU TC.024 


Compiler and assembler option: 
—-silicon-bug=cpu-tc024 


Assembler control: 
$CPU_TC024 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC024__ is defined if you specify option 
—-silicon-bug=cpu-tc024. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates a NOP 
instruction at the very top of any subroutine that starts with a CALL 
instruction or that starts with an integer instruction or MAC instruction 
directly followed by a CALL instruction. 


Assembler check: 


The assembler gives a warning when the first instruction of a subroutine is 
a CALL instruction or an integer instruction or MAC instruction directly 
followed by a CALL instruction. 


Wnum: suspicious instruction concerning CPU functional 
defect TC024 


You can suppress this warning with the option -wnum. 
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CPU_TC.030 


Compiler and assembler option: 
—-silicon-bug=cpu-tc030 
Assembler control: 


$CPU_TC030 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC030__ is defined if you specify option 
—-silicon-bug=cpu-tc030. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates an 
ISYNC instruction prior to the LOOP instruction if the last instruction in the 
loop is a DVSTEP or a DVSTEP.U. 


Assembler check: 


The assembler gives a warning for loops where the last instruction is a 
DVSTEP or a DVSTEP.U: 


Wnum: suspicious instruction concerning CPU functional 
defect TC030 


You can suppress this warning with the option -wnum. 
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CPU TC.031 


Compiler and assembler option: 
—-silicon-bug-cpu-tc031 


Assembler control: 
$CPU_TC031 (on | off) 


Assembler macro: 


The assembler macro __ CPU_TC031__ is defined if you specify option 
—-silicon-bug-cpu-tc031. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates an 
ISYNC instruction prior to the LOOP instruction. 


Assembler check: 


The assembler gives a warning if the LOOP instruction is not preceded by 
an ISYNC instruction: 


Wnum: suspicious instruction concerning CPU functional 
defect TC031 


You can suppress this warning with the option -wnum. 
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CPU_TC.033 


Compiler and assembler option: 
—-silicon-bug=cpu-tc033 


Assembler control: 
$CPU_TC033 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC033___ is defined if you specify option 
—-silicon-bug-cpu-tc033. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler aligns circular 
qualified buffers to a guad-word boundary, and the compiler sizes all 
stack frames to an integral number of guad—words. See section 3.4.1, 
Circular Buffers in the User's Manual, for a description on how to declare 
a circular buffer. 


Assembler bypass: 


To bypass this CPU functional problem, the assembler adds a macro to the 
C startup code to enable initialization of the stack pointers to a quad—word 
boundary. 


Linker bypass: 


A preprocessor define is used in the tc*.1s1 linker script files to set the 
alignment of the user stack and the interrupt stack to a guad-word 
alignment. 
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CPU TC.034 


Compiler and assembler option: 
—-silicon-bug=cpu-tc034 


Assembler control: 
$CPU_TC0234 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC034___ is defined if you specify option 
—-silicon-bug=cpu-tc034. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates an 
ISYNC instruction after each DSYNC instruction. 


Assembler check: 


The assembler gives a warning if a DSYNC instruction is not followed by 
an ISYNC instruction: 


Wnum: suspicious instruction concerning CPU functional 
defect TC034 


You can suppress this warning with the option -wnum. 
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CPU TC.043 


Linker option: 
-D_CPU_TC043 __ 


Linker bypass: 


To bypass this CPU functional problem, a preprocessor define is used in 
the tc*.1s1 linker script files. The linker will not use the last 16 bytes of 
a segment. 
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CPU TC.048 


Compiler and assembler option: 
—-silicon-bug=cpu-tc048 


Assembler control: 


$CPU_TCO48 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC048__ is defined if you specify option 
—-silicon-bug=cpu-tc048. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates a NOP 
instruction before a JI or CALLI instruction when this instruction is not 
directly preceded by either a NOP instruction or an integer instruction or a 
MAC instruction. The compiler also generates a NOP instruction before a 
RET and RET16 instruction if there is no or just one instruction before RET, 
starting from the function entry point. 


Assembler check: 


The assembler gives a warning when a JI or CALLI instruction is not 
directly preceded by a NOP instruction. The assembler also gives a 
warning when there is no or just one instruction (not a NOP instruction) 
between label and RET or RET16: 


Wnum: suspicious instruction concerning CPU functional 
defect TC048 


You can suppress this warning with the option -wnum. 
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CPU TC.050 


Compiler and assembler option: 
—-silicon-bug—-cpu-tc050 
Assembler control: 


$CPU_TC050 (on | off) 


Assembler macro: 


The assembler macro __ CPU_TC050__ is defined if you specify option 
—-silicon-bug-cpu-tc050. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates a NOP 
instruction between a multi-cycle integer instruction and a load 
instruction. 


Assembler check: 


The assembler gives a warning if a multi-cycle integer instruction is 
directly followed by a load instruction.: 


Wnum: suspicious instruction concerning CPU functional 
defect TC050 


You can suppress this warning with the option -wnum. 
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CPU TCO51 


Assembler option: 
—-silicon-bug-cpu-tc051 


Assembler control: 
$CPU_TC051 (on | off) 


Linker option: 
-D_ CPU TC051__ 


Assembler macro: 


The assembler macro __ CPU_TC051__ is defined if you specify the option 
—-silicon-bug-cpu-tc051. 


Assembler bypass: 


To bypass this CPU functional problem, the assembler adds a macro to the 
C startup code. 


Linker bypass: 


To bypass this CPU functional problem, a preprocessor define is used in 
the te*.1s1 linker script files. The linker will use more than one section 
for context stores if the reguired CSA area exceeds the 4k. Each section 
will have a maximum size of 4k and will start on an 8k boundary. 


CPU Functional Problems 9-17 


CPU_TC.060 


Compiler and assembler option: 
—-silicon-bug=cpu-tc060 


Assembler control: 
$CPU_TC060 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC060__ is defined if you specify option 
—-silicon-bug=cpu-tc060. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler generates a NOP 
instruction between an LD.A / LD.DA instruction and a following LD.W / 
LD.D instruction, even if an integer instruction occurs in between. 


Assembler check: 


The assembler gives a warning when an LD.A / LD.DA instruction is 
directly followed by an LD.W / LD.D instruction, or when only an integer 
instruction is in between. 


Wnum: suspicious instruction concerning CPU functional 
defect TC060 


You can suppress this warning with the option -wnum. 
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CPU TC.065 


Compiler and assembler option: 
—-silicon-bug=cpu-tc065 


Assembler control: 
$CPU_TC065 (on | off) 


Assembler macro: 


The assembler macro __ CPU_TC065__ is defined if you specify option 
—-silicon-bug—-cpu-tc065. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler inserts a NOP 
instruction before a jump, when a label is directly followed by an 
unconditional jump. 


Assembler check: 


The assembler gives a warning when a label is directly followed by an 
unconditional jump, only when debug information is turned off. 


Wnum: suspicious instruction concerning CPU functional 
defect TC065 


You can suppress this warning with the option -wnum. 


CPU Functional Problems 


CPU_TC.069 


Compiler and assembler option: 
—-silicon-bug=cpu-tc069 


Assembler control: 
$CPU_TC069 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC069__ is defined if you specify option 
—-silicon-bug=cpu-tc069. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler inserts a NOP 
instruction after each RSLCX instruction. 


Assembler check: 


The assembler gives a warning when an RSLCX instruction is not followed 
by a NOP instruction. 


Wnum: suspicious instruction concerning CPU functional 
defect TC069 


You can suppress this warning with the option -wnum. 
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CPU TC.070 


Compiler and assembler option: 
—-silicon-bug-cpu-tc070 


Assembler control: 
$CPU_TC070 {on | off} 


Assembler macro: 


The assembler macro __ CPU_TC070__ is defined if you specify option 
—-silicon-bug-cpu-tc070. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler inserts a NOP 
instruction before a loop instruction, when a conditional jump, based on 
the value in an address register, is directly followed by a loop instruction. 


The compiler inserts two NOP instructions before a loop instruction, when 
a conditional jump, based on the value in a data register, is directly 
followed by a loop instruction. 


Assembler check: 
The assembler gives a warning when a conditional jump, based on the 
value in an address register, is directly followed by a loop instruction. 


The assembler gives a warning when a conditional jump, based on the 
value in a data register, is directly followed by a loop instruction or when 
only a single NOP instruction is in between. 


Wnum: suspicious instruction concerning CPU functional 
defect TC070 


You can suppress this warning with the option -wnum. 
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CPU TC.071 


Compiler and assembler option: 
—-silicon-bug-cpu-tc071 


Assembler control: 
$CPU_TCO71 (on | off} 


Assembler macro: 


The assembler macro __ CPU_TC071__ is defined if you specify option 
—-silicon-bug-cpu-tc0O71. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler inserts a NOP 
instruction before a loop instruction, when a label is directly followed by 
an unconditional loop instruction. 


Assembler check: 


The assembler gives a warning when a label is directly followed by an 
unconditional loop instruction, only when debug information is turned off. 


Wnum: suspicious instruction concerning CPU functional 
defect TC071 


You can suppress this warning with the option -wnum. 
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CPU TC.072 


Compiler and assembler option: 
—-silicon-bug-cpu-tc072 
Assembler control: 


$CPU_TCO072 (on | off 


Assembler macro: 


The assembler macro __ CPU_TC072__ is defined if you specify option 
—-silicon-bug-cpu-tc072. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler inserts a NOP 
instruction before a loop instruction, when an instruction that updates an 
address register is followed by a conditional loop instruction which uses 
this address register. 


Assembler check: 


The assembler gives a warning when an instruction that updates an 
address register is followed by a conditional loop instruction which uses 
this address register. 


Wnum: suspicious instruction concerning CPU functional 
defect TC072 


You can suppress this warning with the option -wnum. 


CPU Functional Problems 


DMU TC.001 


Compiler and assembler option: 
—-silicon-bug-dmu-tc001 


Assembler control: 
$DMU TC001 (on | off) 


Assembler macro: 


The assembler macro __ DMU_TC001__ is defined if you specify the option 
—-silicon-bug-dmu-tc001. 


Compiler bypass: 


To bypass this CPU functional problem, the C compiler avoids generation 
of the ST.T, SWAP and LDMST instructions. For direct __ bit and bit-field 
operations, alternative instructions are used. 


Assembler check: 
The assembler gives a warning for SWAP, LDMST and ST.T instructions: 


Wnum: suspicious instruction concerning CPU functional 
defect TC001 


You can suppress this warning with the option -wnum. 
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PMI_TC.003 


Assembler option: 
—-silicon-bug—>pmi-tc003 


Assembler control: 
$PMI_TC003 (on | off} 


Assembler macro: 


The assembler macro __ PMI_TC003__ is defined if you specify the option 
—-silicon-bug-pmi-tc003. 


Compiler bypass: 


There is no compiler bypass for this problem. 


Assembler bypass: 


To bypass this CPU functional problem, the assembler adds a macro to the 
C startup code to set the TLB-A and TLB-B mappings to a page size of 16 
Kb. The SZA and SZB in the MMU CON are set to 16 Kb. 


CPU Functional Problems 


PMU_TC.004 


Assembler option: 
—-silicon-bug=pmu-tc004 


Assembler control: 
$PMU_TC004 {on | off} 


Assembler macro: 


The assembler macro __ PMU_TC004 ___ is defined if you specify the option 
—-silicon-bug=pmu-tc004. 


Compiler bypass: 


There is no compiler bypass for this problem. 


Assembler bypass: 
To bypass this CPU functional problem, the assembler adds a macro to the 
C startup code to disable the split mode on the LMB bus. The SPLT bit of 
the SFR register LFI_CON is set to zero. 
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MISRA-C RULES 


ail TASKING M 


d3iLdVHO 


MISRA-C Rules 


10.1 MISRA-C:1998 


This section lists all supported and unsupported MISRA-C:1998 rules. 


d> See also section 5.7, C Code Checking: MISRA-C, in Chapter Using the 
Compiler of the User's Manual. 


& A number of MISRA-C rules leave room for interpretation. Other rules can 
only be checked in a limited way. In such cases the implementation 
decisions and possible restrictions for these rules are listed. 


x means that the rule is not supported by the TASKING C compiler. 
(R) is a reguired rule, (A) is an advisory rule. 


1. (R) The code shall conform to standard C, without language 
extensions 


x 2. (A) Other languages should only be used with an interface 
standard 


3. (A) Inline assembly is only allowed in dedicated C functions 


x 4. (A) Provision should be made for appropriate run-time 
checking 


(R) Only use characters and escape sequences defined by ISO C 


x 6. (R) Character values shall be restricted to a subset of ISO 
106460-1 


(R)  Trigraphs shall not be used 


(R) Multibyte characters and wide string literals shall not be 
used 


9. (R) Comments shall not be nested 

10. (A) Sections of code should not be ”commented out” 
In general, it is not possible to decide whether a piece of 
comment is C code that is commented out, or just some 
pseudo code. Instead, the following heuristics are used to 
detect possible C code inside a comment: 
— a line ends with ’;’, or 
— a line starts with y, possibly preceded by white space 


11. (R) Identifiers shall not rely on significance of more than 31 
characters 


12. (A) The same identifier shall not be used in multiple name 
spaces 
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13. 


14. 
15. 


16. 


17. 
18. 


19. 
20. 


21 
22. 
23. 
24. 
25. 


26. 


ATi 


28. 
29. 
30. 


31. 


(A) 


(R) 
(A) 


(R) 


(R) 
(A) 


(R) 
(R) 


(R) 
(A) 
(A) 
(R) 
(R) 


(R) 


(A) 


(A) 
(R) 
(R) 


(R) 
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Specific-length typedefs should be used instead of the basic 
types 
Use 'unsigned char' or 'signed char' instead of plain 'char' 


Floating point implementations should comply with a 
standard 


The bit representation of floating point numbers shall not be 
used 


A violation is reported when a pointer to a floating point 
type is converted to a pointer to an integer type. 


"typedef” names shall not be reused 
Numeric constants should be suffixed to indicate type 


A violation is reported when the value of the constant is 
outside the range indicated by the suffixes, if any. 


Octal constants (other than zero) shall not be used 


All object and function identifiers shall be declared before 
use 


Identifiers shall not hide identifiers in an outer scope 
Declarations should be at function scope where possible 

All declarations at file scope should be static where possible 
Identifiers shall not have both internal and external linkage 


Identifiers with external linkage shall have exactly one 
definition 

Multiple declarations for objects or functions shall be 
compatible 

External objects should not be declared in more than one 
file 

The "register” storage class specifier should not be used 
The use of a tag shall agree with its declaration 

All automatics shall be initialized before being used 


This rule is checked using worst-case assumptions. This 
means that violations are reported not only for variables that 
are guaranteed to be uninitialized, but also for variables that 
are uninitialized on some execution paths. 


Braces shall be used in the initialization of arrays and 
structures 


MISRA-C Rules 


32. 


33. 


34. 


35. 


36. 


37. 


38. 


39. 


40. 


42. 
43. 


44. 
45. 


46. 


47. 


48. 


(R) 


(R) 


(R) 


(R) 


(A) 


(R) 


(R) 


(R) 


(A) 
(A) 


(R) 
(R) 


(A) 
(R) 


(R) 


(A) 


(A) 


Only the first, or all enumeration constants may be 
initialized 

The right hand operand of && or | | shall not contain side 
effects 


The operands of a logical && or | | shall be primary 
expressions 


Assignment operators shall not be used in Boolean 
expressions 


Logical operators should not be confused with bitwise 
Operators 


Bitwise operations shall not be performed on signed 
integers 


A shift count shall be between 0 and the operand width 
minus 1 


This violation will only be checked when the shift count 
evaluates to a constant value at compile time. 


The unary minus shall not be applied to an unsigned 
expression 


*sizeof’ should not be used on expressions with side effects 


The implementation of integer division should be 
documented 


The comma operator shall only be used in a ”for” condition 


Don't use implicit conversions which may result in 
information loss 


Redundant explicit casts should not be used 


Type casting from any type to or from pointers shall not be 
used 


The value of an expression shall be evaluation order 
independent 


This rule is checked using worst-case assumptions. This 
means that a violation will be reported when a possible alias 
may cause the result of an expression to be evaluation order 
dependent. 


No dependence should be placed on operator precedence 
rules 


Mixed arithmetic should use explicit casting 


10-6 TriCore Reference Manual 


49. (A) Tests of a (non-Boolean) value against 0 should be made 
explicit 


50. (R) F.P. variables shall not be tested for exact eguality or 
ineguality 


51. (A) Constant unsigned integer expressions should not 
wrap-around 


52. (R) There shall be no unreachable code 

53. R) All non-null statements shall have a side-effect 

54. (R) A null statement shall only occur on a line by itself 
55. (A) Labels should not be used 

56. (R) The “goto” statement shall not be used 

57. (R) The ”continue” statement shall not be used 


58. (R) The “break” statement shall not be used (except in a 
*switch”) 


59. (R) An if? or loop body shall always be enclosed in braces 
60. (A) All “if”, ’else if” constructs should contain a final "else” 


61. (R) Every non-empty ”case” clause shall be terminated with a 
“break” 


62. (R) All *switch” statements should contain a final "default” case 
63. (A) A “switch” expression should not represent a Boolean case 
64. (R) Every ”switch” shall have at least one case” 

65. (R) Floating point variables shall not be used as loop counters 


66. (A) A for” should only contain expressions concerning loop 
control 


A violation is reported when the loop initialization or loop 
update expression modifies an object that is not referenced 
in the loop test. 


67. (A) Iterator variables should not be modified in a for” loop 
68. (R) Functions shall always be declared at file scope 


69. (R) Functions with variable number of arguments shall not be 
used 


MISRA-C Rules 
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70. 


71. 
72: 


Tas 


74. 


75. 
76. 


77. 


78. 
79. 
80. 
81. 


82. 
83. 


84. 
85. 


86. 


87. 


88. 


(R) 


(R) 
(R) 


(R) 


(R) 


(R) 
(R) 


(R) 


(R) 
(R) 
(R) 
(A) 


(A) 
(R) 


(R) 
(A) 


(A) 


(R) 


(R) 


Functions shall not call themselves, either directly or 
indirectly 


A violation will be reported for direct or indirect recursive 
function calls in the source file being checked. Recursion via 
functions in other source files, or recursion via function 
pointers is not detected. 


Function prototypes shall be visible at the definition and call 


The function prototype of the declaration shall match the 
definition 


Identifiers shall be given for all prototype parameters or for 
none 


Parameter identifiers shall be identical for 
declaration/definition 


Every function shall have an explicit return type 


Functions with no parameters shall have a ”void” parameter 
list 


An actual parameter type shall be compatible with the 
prototype 


The number of actual parameters shall match the prototype 
The values returned by ”void” functions shall not be used 
Void expressions shall not be passed as function parameters 


”const” should be used for reference parameters not 
modified 


A function should have a single point of exit 


Every exit point shall have a "return” of the declared return 
type 
For "void” functions, ”return” shall not have an expression 


Function calls with no parameters should have empty 
parentheses 


If a function returns error information, it should be tested 


A violation is reported when the return value of a function 
is ignored. 


“include shall only be preceded by other directives or 
comments 


Non-standard characters shall not occur in #include 
directives 
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89. (R) #include shall be followed by either <filename> or 
filename” 


90. (R) Plain macros shall only be used for 
constants/gualifiers/specifiers 


91. (R) Macros shall not be #define’d and #undefd within a block 
92. (A) #undef should not be used 


93. (A) A function should be used in preference to a function-like 
macro 


94. (R) A function-like macro shall not be used without all 
arguments 


95. (R) Macro arguments shall not contain pre-preprocessing 
directives 


A violation is reported when the first token of an actual 
macro argument is #. 


96. (R) Macro definitions/parameters should be enclosed in 
parentheses 


97. (A) Don't use undefined identifiers in pre-processing directives 


98. (R) A macro definition shall contain at most one # or ## 
operator 


99. (R) All uses of the #pragma directive shall be documented 


This rule is really a documentation issue. The compiler will 
flag all #pragma directives as violations. 


100. (R) “defined” shall only be used in one of the two standard 
forms 


101. (A) Pointer arithmetic should not be used 

102. (A) No more than 2 levels of pointer indirection should be used 
A violation is reported when a pointer with three or more 
levels of indirection is declared. 

103. (R) No relational operators between pointers to different objects 


In general, checking whether two pointers point to the same 
object is impossible. The compiler will only report a 
violation for a relational operation with incompatible pointer 
types. 


104. (R) Non-constant pointers to functions shall not be used 


105. (R) Functions assigned to the same pointer shall be of identical 
type 
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106. 


107. 


108. 
109. 


110. 


111. 
112. 
113. 
114. 
115. 
x 116. 


x 117. 
118. 
119. 
120. 
121. 
122. 
123. 
124. 
125. 
126. 
127. 


(R) 


(R) 


(R) 
(R) 


(R) 


(R) 
(R) 
(R) 
(R) 
(R) 
(R) 


(R) 
(R) 
(R) 
(R) 
(R) 
(R) 
(R) 
(R) 
(R) 
(R) 
(R) 


Automatic address may not be assigned to a longer lived 
object 


The null pointer shall not be de-referenced 


A violation is reported for every pointer dereference that is 
not guarded by a NULL pointer test. 


All struct/union members shall be fully specified 
Overlapping variable storage shall not be used 
A violation is reported for every 'union' declaration. 


Unions shall not be used to access the sub-parts of larger 
types 


A violation is reported for a 'union' containing a 'struct 
member. 


Bit fields shall have type "unsigned int” or "signed int” 

Bit fields of type ”signed int” shall be at least 2 bits long 
All struct/union members shall be named 

Reserved and standard library names shall not be redefined 
Standard library function names shall not be reused 


Production libraries shall comply with the MISRA-C 
restrictions 


The validity of library function parameters shall be checked 
Dynamic heap memory allocation shall not be used 

The error indicator ”"errno” shall not be used 

The macro ”offsetof” shall not be used 

<locale.h> and the ”setlocale” function shall not be used 
The ”setjmp” and "longjmp” functions shall not be used 
The signal handling facilities of <signal.h> shall not be used 
The <stdio.h> library shall not be used in production code 
The functions atof/atoi/atol shall not be used 

The functions abort/exit/getenv/system shall not be used 


The time handling functions of library <time.h> shall not be 
used 
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10.2 MISRA-C:2004 


This section lists all supported and unsupported MISRA-C:2004 rules. 


d> See also section 5.7, C Code Checking: MISRA-C, in Chapter Using the 
Compiler of the User's Manual. 


& A number of MISRA-C rules leave room for interpretation. Other rules can 
only be checked in a limited way. In such cases the implementation 
decisions and possible restrictions for these rules are listed. 


x means that the rule is not supported by the TASKING C compiler. 
(R) is a reguired rule, (A) is an advisory rule. 


Environment 


1.1 (R) All code shall conform to ISO 9899:1990 ”Programming 
languages — C”, amended and corrected by ISO/IEC 
9899/COR1:1995, ISO/IEC 9899/AMD1:1995, and ISO/IEC 
9899/COR2:1996. 


1.2 (R) No reliance shall be placed on undefined or unspecified 
behavior. 


x 1.3 (R) Multiple compilers and/or languages shall only be used if 
there is a common defined interface standard for object 
code to which the languages/compilers/assemblers conform. 


x 1.4 (R) The compiler/linker shall be checked to ensure that 31 
character significance and case sensitivity are supported for 
external identifiers. 


x 15 (A) Floating-point implementations should comply with a 
defined floating-point standard. 


Language extensions 


2.1 (R) Assembly language shall be encapsulated and isolated. 


2.2 (R) Source code shall only use /* ... */ style comments. 


MISRA-C Rules 
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2.3 


2.4 


(R) 


(A) 


The character seguence /* shall not be used within a 
comment. 


Sections of code should not be "commented out”. 


In general, it is not possible to decide whether a piece of 
comment is C code that is commented out, or just some 
pseudo code. Instead, the following heuristics are used to 
detect possible C code inside a comment: 

— a line ends with ’;’, or 


— a line starts with y, possibly preceded by white space 


Documentation 


X 3.1 


= 3.2 


* 3.3 


3.4 


2.5 


Character sets 


4.1 


4.2 


(R) 


(R) 


(A) 


(R) 


(R) 


(R) 


(R) 


(R) 


All usage of implementation-defined behavior shall be 
documented. 


The character set and the corresponding encoding shall be 
documented. 


The implementation of integer division in the chosen 
compiler should be determined, documented and taken into 
account. 


All uses of the #pragma directive shall be documented and 
explained. 


This rule is really a documentation issue. The compiler will 
flag all #pragma directives as violations. 


The implementation-defined behavior and packing of bit 
fields shall be documented if being relied upon. 


All libraries used in production code shall be written to 
comply with the provisions of this document, and shall have 
been subject to appropriate validation. 


Only those escape seguences that are defined in the ISO C 
standard shall be used. 


Trigraphs shall not be used. 
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Identifiers 


5.1 (R) 
5.2 (R) 
5.3 (R) 


5.4 (R) 
x 55 (A) 


5.6 (A) 


x 57 A) 


61 (R) 
x 62 (R) 
6.3 (A) 
6.4 (R) 
65 (R) 


Constants 


71 ® 
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Identifiers (internal and external) shall not rely on the 
significance of more than 31 characters. 


Identifiers in an inner scope shall not use the same name as 
an identifier in an outer scope, and therefore hide that 
identifier. 


A typedef name shall be a unigue identifier. 
A tag name shall be a unigue identifier. 


No object or function identifier with static storage duration 
should be reused. 


No identifier in one name space should have the same 
spelling as an identifier in another name space, with the 
exception of structure and union member names. 


No identifier name should be reused. 


The plain char type shall be used only for storage and use 
of character values. 


signed and unsigned char type shall be used only for 
the storage and use of numeric values. 


typedefs that indicate size and signedness should be used 
in place of the basic types. 


Bit fields shall only be defined to be of type unsigned int 
or signed int. 


Bit fields of type signed int shall be at least 2 bits long. 


Octal constants (other than zero) and octal escape 
seguences shall not be used. 


Declarations and definitions 


81 (R) 


82 (R) 


Functions shall have prototype declarations and the 
prototype shall be visible at both the function definition and 
call. 


Whenever an object or function is declared or defined, its 
type shall be explicitly stated. 
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8.3 


8.4 


8.5 


8.6 
8.7 


x 8.8 


8.11 


8.12 


Initialization 


91 


9.2 


9.3 


(R) 


(R) 


(R) 


(R) 
(R) 


(R) 


(R) 


(R) 


(R) 


(R) 


(R) 


(R) 


(R) 


For each function parameter the type given in the 
declaration and definition shall be identical, and the return 
types shall also be identical. 


If objects or functions are declared more than once their 
types shall be compatible. 


There shall be no definitions of objects or functions in a 
header file. 


Functions shall be declared at file scope. 


Objects shall be defined at block scope if they are only 
accessed from within a single function. 


An external object or function shall be declared in one and 
only one file. 


An identifier with external linkage shall have exactly one 
external definition. 


All declarations and definitions of objects or functions at file 
scope shall have internal linkage unless external linkage is 
reguired. 


The static storage class specifier shall be used in 
definitions and declarations of objects and functions that 
have internal linkage. 


When an array is declared with external linkage, its size 
shall be stated explicitly or defined implicitly by 
initialization. 


All automatic variables shall have been assigned a value 
before being used. 


This rule is checked using worst-case assumptions. This 
means that violations are reported not only for variables that 
are guaranteed to be uninitialized, but also for variables that 
are uninitialized on some execution paths. 


Braces shall be used to indicate and match the structure in 
the non—zero initialization of arrays and structures. 


5» 


In an enumerator list, the construct shall not be used to 
explicitly initialize members other than the first, unless all 
items are explicitly initialized. 
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Arithmetic type conversions 


10.1 R) 


10.2 (R) 


10.3 (R) 


10.4 R) 


10.5 (R) 


10.6 (R) 


The value of an expression of integer type shall not be 
implicitly converted to a different underlying type if: 

a) it is not a conversion to a wider integer type of the same 
signedness, or 

b) the expression is complex, or 

c) the expression is not constant and is a function argument, 
or 

d) the expression is not constant and is a return expression. 


The value of an expression of floating type shall not be 
implicitly converted to a different type if: 

a) it is not a conversion to a wider floating type, or 

b) the expression is complex, or 

c) the expression is a function argument, or 

d) the expression is a return expression. 


The value of a complex expression of integer type may only 
be cast to a type that is narrower and of the same 
signedness as the underlying type of the expression. 


The value of a complex expression of floating type may 
only be cast to a narrower floating type. 


If the bitwise operators 7 and << are applied to an operand 
of underlying type unsigned char or unsigned short, 
the result shall be immediately cast to the underlying type of 
the operand. 


A ”U” suffix shall be applied to all constants of unsigned 
type. 


Pointer type conversions 


11.1 R) 


11.2 (R) 


11.3 (A) 


Conversions shall not be performed between a pointer to a 
function and any type other than an integral type. 


Conversions shall not be performed between a pointer to 
object and any type other than an integral type, another 
pointer to object type or a pointer to void. 


A cast should not be performed between a pointer type and 
an integral type. 
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11.4 


11.5 


(A) 


(R) 


Expressions 


12.1 


12.2 


12.9 


12.10 
12.11 


(A) 


(R) 


(R) 


(R) 


(R) 


(A) 


(R) 


(R) 


(R) 


(R) 
A) 


A cast should not be performed between a pointer to object 
type and a different pointer to object type. 


A cast shall not be performed that removes any const or 
volatile gualification from the type addressed by a 
pointer. 


Limited dependence should be placed on C’s operator 
precedence rules in expressions. 


The value of an expression shall be the same under any 
order of evaluation that the standard permits. 


This rule is checked using worst-case assumptions. This 
means that a violation will be reported when a possible alias 
may cause the result of an expression to be evaluation order 
dependent. 


The sizeof operator shall not be used on expressions that 
contain side effects. 


The right-hand operand of a logical && or | | operator shall 
not contain side effects. 


The operands of a logical && or | | shall be 
primary-expressions. 


The operands of logical operators (&&, | | and !) should be 
effectively Boolean. Expressions that are effectively Boolean 
should not be used as operands to operators other than (&&, 
| | and !). 


Bitwise operators shall not be applied to operands whose 
underlying type is signed. 


The right-hand operand of a shift operator shall lie between 
zero and one less than the width in bits of the underlying 
type of the left-hand operand. 


This violation will only be checked when the shift count 
evaluates to a constant value at compile time. 


The unary minus operator shall not be applied to an 
expression whose underlying type is unsigned. 


The comma operator shall not be used. 


Evaluation of constant unsigned integer expressions should 
not lead to wrap-around. 
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(R) 


(A) 
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The underlying bit representations of floating-point values 
shall not be used. 


A violation is reported when a pointer to a floating point 
type is converted to a pointer to an integer type. 


The increment (++) and decrement (—-) operators should 
not be mixed with other operators in an expression. 


Control statement expressions 


13.1 


13.2 


13.3 


13.4 


13.5 


13.6 


13.7 


(R) 


(A) 


(R) 


(R) 


(R) 


(R) 


(R) 


Control flow 


14.1 
14.2 


14.3 


14.4 
14.5 


(R) 
(R) 


(R) 


(R) 
(R) 


Assignment operators shall not be used in expressions that 
yield a Boolean value. 


Tests of a value against zero should be made explicit, unless 
the operand is effectively Boolean. 


Floating-point expressions shall not be tested for equality or 
inequality. 

The controlling expression of a for statement shall not 
contain any objects of floating type. 


The three expressions of a for statement shall be 
concerned only with loop control. 


A violation is reported when the loop initialization or loop 
update expression modifies an object that is not referenced 
in the loop test. 


Numeric variables being used within a for loop for iteration 
counting shall not be modified in the body of the loop. 


Boolean operations whose results are invariant shall not be 
permitted. 


There shall be no unreachable code. 


All non-null statements shall either: 
a) have at least one side effect however executed, or 
b) cause control flow to change. 


Before preprocessing, a null statement shall only occur on a 
line by itself; it may be followed by a comment provided 
that the first character following the null statement is a 
white-space character. 


The goto statement shall not be used. 


The continue statement shall not be used. 
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14.6 (R) 
147 (R) 
148 (R) 


149 (R) 


14.10 (R) 


For any iteration statement there shall be at most one break 
statement used for loop termination. 


A function shall have a single point of exit at the end of the 
function. 


The statement forming the body of a switch, while, do 
... while or for statement be a compound statement. 


Anif (expression) construct shall be followed by a 
compound statement. The else keyword shall be followed 
by either a compound statement, or another if statement. 


All if ... else if constructs shall be terminated with an 
else clause. 


Switch statements 


151 R) 


15.2 (R) 
15.3 (R) 
15.4 (R) 
15.5 (R) 


Functions 


16.1 R) 


162 (R) 


163 R) 


16.4 (R) 


A switch label shall only be used when the most 
closely-enclosing compound statement is the body of a 
switch statement. 


An unconditional break statement shall terminate every 
non-empty switch clause. 


The final clause of a switch statement shall be the default 
clause. 


A switch expression shall not represent a value that is 
effectively Boolean. 


Every switch statement shall have at least one case clause. 


Functions shall not be defined with variable numbers of 
arguments. 


Functions shall not call themselves, either directly or 
indirectly. 


A violation will be reported for direct or indirect recursive 
function calls in the source file being checked. Recursion via 
functions in other source files, or recursion via function 
pointers is not detected. 


Identifiers shall be given for all of the parameters in a 
function prototype declaration. 


The identifiers used in the declaration and definition of a 
function shall be identical. 


10-17 


10-18 


16.5 


16.6 


16.7 


16.8 


16.9 


16.10 


(R) 


(R) 


(A) 


(R) 


(R) 
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Functions with no parameters shall be declared with 
parameter type void. 


The number of arguments passed to a function shall match 
the number of parameters. 


A pointer parameter in a function prototype should be 
declared as pointer to const if the pointer is not used to 
modify the addressed object. 


All exit paths from a function with non—void return type 
shall have an explicit return statement with an expression. 


A function identifier shall only be used with either a 
preceding &, or with a parenthesized parameter list, which 
may be empty. 

If a function returns error information, then that error 
information shall be tested. 


A violation is reported when the return value of a function 
is ignored. 


Pointers and arrays 


x 17.1 


17.3 


17.4 


17.5 


17.6 


(R) 


(R) 


(R) 


(R) 


(A) 


(R) 


Pointer arithmetic shall only be applied to pointers that 
address an array or array element. 


Pointer subtraction shall only be applied to pointers that 
address elements of the same array. 


>, >=, <, <= shall not be applied to pointer types except 
where they point to the same array. 


In general, checking whether two pointers point to the same 
object is impossible. The compiler will only report a 
violation for a relational operation with incompatible pointer 
types. 


Array indexing shall be the only allowed form of pointer 
arithmetic. 


The declaration of objects should contain no more than 2 
levels of pointer indirection. 

A violation is reported when a pointer with three or more 
levels of indirection is declared. 


The address of an object with automatic storage shall not be 
assigned to another object that may persist after the first 
object has ceased to exist. 
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Structures and unions 


181 


18.2 
x 18.3 


18.4 


(R) 


(R) 
(R) 


(R) 


All structure or union types shall be complete at the end of 
a translation unit. 


An object shall not be assigned to an overlapping object. 


An area of memory shall not be reused for unrelated 
purposes. 


Unions shall not be used. 


Preprocessing directives 


191 


19.2 


x 19.3 


19.4 


19.5 


19.6 
19.7 


19.8 


19.9 


19.10 


19.11 


19.12 


(A) 


(A) 


(R) 


(R) 


(R) 


(R) 
(A) 


(R) 


(R) 


(R) 


(R) 


(R) 


#include statements in a file should only be preceded by 
other preprocessor directives or comments. 


Non-standard characters should not occur in header file 
names in #include directives. 


The #include directive shall be followed by either a 
<filename> or filename” sequence. 


C macros shall only expand to a braced initializer, a 
constant, a parenthesized expression, a type qualifier, a 
storage class specifier, or a do-while—zero construct. 


Macros shall not be #define’d or #undef’d within a block. 
fundef£ shall not be used. 


A function should be used in preference to a function-like 
macro. 


A function-like macro shall not be invoked without all of its 
arguments. 


Arguments to a function-like macro shall not contain tokens 
that look like preprocessing directives. 


A violation is reported when the first token of an actual 
macro argument is 'F. 


In the definition of a function-like macro each instance of a 
parameter shall be enclosed in parentheses unless it is used 
as the operand of # or ##. 


All macro identifiers in preprocessor directives shall be 
defined before use, except in #ifdef and #ifndef 
preprocessor directives and the defined() operator. 


There shall be at most one occurrence of the # or ## 
preprocessor operators in a single macro definition. 


10-19 


10-20 
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19.13 (A) The # and ## preprocessor operators should not be used. 

19.14 (R) The defined preprocessor operator shall only be used in 
one of the two standard forms. 

19.15 (R) Precautions shall be taken in order to prevent the contents 
of a header file being included twice. 

19.16 (R) Preprocessing directives shall be syntactically meaningful 
even when excluded by the preprocessor. 

19.17 (R) All #else, #elif and #endif preprocessor directives shall 
reside in the same file as the #if or #ifdef directive to 
which they are related. 

Standard libraries 

20.1 (R) Reserved identifiers, macros and functions in the standard 
library, shall not be defined, redefined or undefined. 

20.2 (R) The names of standard library macros, objects and functions 
shall not be reused. 

x 20.3 (R) The validity of values passed to library functions shall be 

checked. 

20.4 (R) Dynamic heap memory allocation shall not be used. 

20.5 (R) The error indicator errno shall not be used. 

20.6 (R) The macro offsetof, in library <stddef .h>, shall not be 
used. 

20.7 (R) The setjmp macro and the longjmp function shall not be 
used. 

20.8 (R) The signal handling facilities of <signal.h> shall not be 
used. 

20.9 (R) The input/output library <stdio.h> shall not be used in 
production code. 

20.10 (R) The library functions atof, atoi and atol from library 
<stdlib.h> shall not be used. 

20.11 (R) The library functions abort, exit, getenv and system 
from library <stdlib.h> shall not be used. 

20.12 (R) The time handling functions of library <time.h> shall not 


be used. 
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Run-time failures 


x 211 (R) Minimization of run-time failures shall be ensured by the 
use of at least one of: 
a) static analysis tools/technigues; 
b) dynamic analysis tools/technigues; 
c) explicit coding of checks to handle run-time faults. 
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—-error-file, 5-79 

—-fbu-present, 5-82 

—-belp, 5-69 

—-include-directory, 5-86 
include-file, 5-85 

--is-tricore2, 5-89 
Reep-ouiput—files, 5-90 

—-/ist-file, 5-93 

—-/isl-format, 5-91 

-mmu-presenl, 5-95 
no-iasking-sfr, 5-96 

—-no-warnings, 5-104 


Index 


—-optimize, 5-97 
—-option—file, 5-80 
—-output, 5-98 
—-preprocessor-type, 5-94 
section-info, 5-101 
silicon-bug, 5-99 
—-symbol-scope, 5-88 
—-version, 5-103 
—-warnings-as-errors, 5-106 
-C, 5-70 
-c, 5-72 
-D, 5-74 
Sf, 5-80 
-g, 5-83 
-H, 5-85 
-I, 5-86 
-t, 5-88 
-k, 5-90 
-L, 5-91 
-l, 5-93 
—m, 5-94 
-O, 5-97 
-o, 5-98 
-t, 5-101 
-V, 5-103 
-w, 5-104 
assembly functions 
abs, 3-6 
acs, 3-7 
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unf, 3-18 
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at2, 3-8 
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atanh functions, 2-14 
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bit handling, 1-23 
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BUFSIZ, 2-23 

bus definition, 8-4 
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byte, 3-25 
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C library, reentrancy, 2-48 
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cacos, 2-5 
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case, 3-67 

case sensitivity, 5-112 
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cbrt functions, 2-17 
ccos, 2-5 
ccosh, 2-5 
ceil functions, 2-15 
cel, 3-8 
cexp, 2-5 
char type, treat as unsigned, 5-59 
chdir, 2-44 
check source code, 5-11, 5-73, 5-159 
cimag, 2-5 
clear/noclear, 1-27 
clearerr, 2-33 
clock, 2-42 
clock_t, 2-41 
CLOCKS PER SEC, 2-42 
clog, 2-5 
close, 2-44 
cnt, 3-8 
coh, 3-9 
command file, 5-21, 5-80, 5-121, 
5-168, 5-228 
comment, 3-28 
comments, 8-7 
common subexpression elimination, 
5-12 
compiler options 
-? 5-4 
—-align, 5-7 
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—-cpu, 5-8 
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debug-info, 5-24 
default-a0-size, 5-66 
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default-near-size, 5-39 
—-define, 5-13 
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—-fpu-present, 5-23 
—-belp, 5-4 
—-include-directory, 5-26 
include-file, 5-25 
—-indirect, 5-28 
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--indirect-runtime, 5-29 -n, 5-41 

--inline, 5-30 —-optimize, 5-43 
inline-max-incr, 5-31 -O, 5-43 
inline-max-size, 5-31 -0, 5-46 

—-integer-enumeration, 5-33 -R, 5-48 

—-is-tricore2, 5-34 -s, 5-50 

—-iso, 5-10 -t, 5-57 
keep-output—files, 5-35 -U, 5-58 

—-language, 5-5 -u, 5-59 

--misrac, 5-36 -V, 5-60 

—-misrac-advisory—warnings, 5-37 —w, 5-61 

—-misrac-required-warnings, 5-37 -Y, 5-64 

--misrac-version, 5-38 -Z, 5-66 

--no-double, 5-20 complex, 2—4 
no-tasking-sfr, 5-42 conditional make rules, 5-214 

—-no-warnings, 5-61 conj, 2-5 

—-object-comment, 5-47 Conjugate value, 2-5 

—-option-file, 5-21 control program options 

—-ouipul, 5-46 -?, 5-154 

—-preprocess, 5-17 address-size, 5-155 

—-rename-sections, 5-48 —-case-sensitive, 5-157 
section—per-data-object, 5-51 —-check, 5-159 
silicon-bug, 5-52, 5-55 -—-cpu, 5-156 

—-source, 5-50 —-create, 5-158 

—-static, 5-54 —d, 5-162 

—-stdout, 5-41 debug-info, 5-177 

—-tradeoff, 5-57 —-define, 5-160 

--uchar, 5-59 —-diag, 5-163 

—-undefine, 5-58 —dry-run, 5-191 

—-version, 5-60 —-error-file, 5-165 

—-warnings-as-errors, 5-63 —-exeptions, 5-166 

-A, 5-5 —-force-c, 5-170 

-C, 5-8 --force-c++, 5-171 

=c, 5-10 --force-munch, 5-172 

-D, 5-13 —-force-prelink, 5-173 

-E, 5-17 —-format, 5-174 

-F, 5-20 —-fptrap, 5-175 

Sf, 5-21 —-fpu-present, 5-176 

-g, 5-24 —-belp, 5-154 

-H, 5-25 ignore—default-library-path, 

-I, 5-26 5-186 

-k, 5-35 —-include-directory, 5-178 


-N, 5-39 —-instantiate, 5-179 
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—-insiantiation-dir, 5-181 
—-instantiation-file, 5-182 
—-is-tricore2, 5-183 
—-iso, 5-184 
keep-output—files, 5-185 
—-keep-temporary-—files, 5-205 
—-library, 5-188 
—-library-directory, 5-186 
list-object—files, 5-189 
—-Isl-file, 5-162 
--mmu-present, 5-190 


--no-auto-instantiation, 5-192 


--no-default-libraries, 5-193 
--no-double, 5-167 
no-map-file, 5-194 


—-no-one-instantiation—per-object, 


5-195 

no-tasking-sfr, 5-196 
—-no-warnings, 5-211 
—-option-file, 5-168 
—-output, 5-197 
—pass, 5-210 
—-pass-assembler, 5-210 
—-pass-c, 5-210 
—-pass-linker, 5-210 
—~pass-c++, 5-210 
—-pass-prelinker, 5-210 


-prelink-copy-if-non-local, 5-198 


-prelink-local-only, 5-199 


-prelink-remove-instantiation—flags 


, 5-200 
—-preprocess, 5-164 
—-show-c++-warnings, 5-201 
silicon-bug, 5-202 
—-space, 5-203 
—-static, 5-204 
—undefine, 5-206 


—-use-double-precision- fp, 5-207 


—-verbose, 5-209 

—-version, 5-208 
—warnings-as-errors, 5-212 
-C, 5-156 

-cc, 5-158 


-cl, 5-158 
-co, 5-158 
-cs, 5-158 
-D, 5-160 
-E, 5-104 
-F, 5-107 
-f, 5-168 
-g, 5-177 
-I, 5-178 
-k, 5-185 
-L, 5-186 
-l, 5-188 
—n, 5-191 
-0, 5-197 
-t, 5-205 
-U, 5-206 
-V, 5-208 
v, 5-209 
-W, 5-210 
-w, 5-211 
-Wa, 5-210 
-Wc, 5-210 
-Wcp, 5-210 
-WI, 5-210 
-Wpl, 5-210 
controls 
See also assembler directives 
detailed description, 3-66 
copy table, 5-138, 8-25, 8-48 
copysign functions, 2-17 
core type, 5-70 
cos, 3-9 
cos functions, 2-13 
cosh functions, 2-13 
cpow, 2-5 
cproj, 2-6 
cpu, 3-9 
CPU type, 5-8, 5-70, 5-156 
cpu_tc, 3-68 
creal, 2-6 
CSE, 5-12 
csin, 2-5 
csinh, 2-5 
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csqrt, 2-5 
cstart.asm, 4-3 
ctan, 2-5 

ctanh, 2-5 

ctime, 2-42 

cvf, 3-9 

cvi, 3-9 

cycle count, 5-101 


data types, 1-4 
debug, 3-69 
debug information, 5-24, 5-83, 5-147 
def, 3-10 
default a0 size, 1-27 
default al size, 1-27 
default near size, 1-27 
define, 3-29 
derivative definition, 8-4, 8-29 
difftime, 2-42 
directives 
See also assembler directives 
detailed description, 3-21 
div, 2-37 
dmu_tc, 3-68 
double, 3-39 
dptr, 3-10 
dup, 3-30 
dupa, 3-31 
dupc, 3-32 
dupf, 3-33 


ELF/DWARF object format, 7-3 
elif, 3-42 

else, 3-42 

end, 3-34 

endif, 3—42 

enum, 5-33 


EOF, 2-23 

equ, 3-35 

erf functions, 2-18 

erfc functions, 2-18 
errno, 2-7 

errno declaration, 2-59 
errno.h, 2-59 
exceptions, floating-point, 4-13 
exit, 2-36 

exit macro, 3-36 
EXIT_FAILURE, 2-34 
EXIT_SUCCES, 2-34 
exitm, 3-36 

exp, 3-10 

exp functions, 2-14 
exp2 functions, 2-14 
expm1 functions, 2-14 
extension isuffix, 1-27 
extern, 1-27, 3-37 


F 


fabs functions, 2-17 
fail, 3-38 

fclose, 2-24 

fdim functions, 2-18 
FE ALL EXCEPT, 2-10 
FE DIVBYZERO, 2-10 
FE INEXACT, 2-10 

FE INVALID, 2-10 

FE OVERFLOW, 2-10 
FE UNDERFLOW, 2-10 
feclearexcept, 2-9 
fegetenv, 2-9 
fegetexceptflag, 2-9 
feholdexept, 2-9 

feof, 2-33 
feraiseexcept, 2-9 
ferror, 2-33 

fesetenv, 2-9 
fesetexceptflag, 2-9 
fetestexcept, 2-9, 2-10 


Index-9 


Index-10 


- 


feupdateenv, 2-9 
fflush, 2-25 
fgetc, 2-29 
fgetpos, 2-32 
fgets, 2-29 
fgetwc, 2-29 
fgetws, 2-29 
File system simulation, 2—4 
FILENAME MAX, 2-23 
fld, 3-11 
float, 3-39 
floating-point, 4-10 
libraries, 4-13 
single precision, 5-23, 5-82, 5-176 
special values, 4-13 
trap handler, 4-14 
trap handling api, 4-15 
trapping, 4-13 
floor functions, 2-15 
flr, 3-11 
fma functions, 2-17 
fmax functions, 2-18 
fmin functions, 2-18 
fmod functions, 2-16 
fopen, 2-24 
FOPEN_ MAX, 2-23 
for_constant data use memory, 1-28 
for extern data use memory, 1-28 
for initialized data_use memory, 1-28 
for uninitialized data use memory, 
1-28 
fpclassify, 2-19 
fprintf, 2-31 
fputc, 2-30 
fputs, 2-30 
fputwc, 2-30 
fputws, 2-30 
fract, 3-11, 3-40 
fractional arithmetic support, 1-14 
fread, 2-32 
free, 2-35 
freopen, 2-25 
frexp functions, 2-16 


Index 


fscanf, 2-29 

fseek, 2-32 

fsetpos, 2-32 

FSS, 2-4 

ftell, 2-32 

functional problems, 9-3 
functions, assembly, 3-3 
fwprintf, 2-31 

fwrite, 2-32 

fwscanf, 2-29 


G 


getc, 2-29 
getchar, 2-29 
getcwd, 2-44 
getenv, 2-36 
gets, 2-29 
getwc, 2-29 
getwchar, 2-29 
global, 3-41 
gmtime, 2-42 


half, 3-63 

Header files, 2-4 
dlert.h, 2-4 
complex.h, 2-4 
ctype.h, 2-6 
errno.h, 2-7 
fcnil.b, 2-9 
fenv.h, 2-9 
float.b, 2-10 
fss.b, 2-10 
inttypes.b, 2-11 
iso646.b, 2-12 
limits.b, 2-12 
locale.h, 2-12 
matb.b, 2-13 


Index 


setljmp.b, 2-20 
signal.h, 2-20 
stdarg.b, 2-21 
sidbool.b, 2-21 
stddef.b, 2-22 
stdint.b, 2-11 
stdio.h, 2-22 
sidlib.b, 2-33 
siring.b, 2-37 
lgmatb.b, 2-13 
time.h, 2-41 
unistd.b, 2-44 
wehar.h, 2-22, 2-37, 2-41, 2-45 
wctype.b, 2-6, 2-46 

heap, 4-10, 8-24 
begin of, 4-10 
end of, 4-10 

hi, 3-11 

his, 3-12 

hw_only, 3-71 

hypot functions, 2-17 


ident, 3-72 

if, 3-42 

ilogb functions, 2-14 

imaginary, 2-4 

imaxabs, 2-11 

imaxdiv, 2-11 

include, 3-44 

indirect, 1-28 

indirect function calling, 5-28, 5-29 
indirect_runtime, 1-28 

init_r7, 3-12 

inline functions, 5-31 
inline/noinline, 1-28 

insert assembly instruction, 1-21 
int, 3-12 

Intel hex, record type, 7-8 
interrupt handling, 1-19 


intrinsic functions, 1-12 
bit handling, 1-23 
fractional data type, 1-14 
insert assembly instruction, 1-21 
interrupt handling, 1-19 
min/max of integers, 1-13 
miscellaneous, 1-25 
packed data type, 1-15 
register handling, 1-22 

iob structures, 2-59 

isalnum, 2-6 

isalpha, 2-6 

isblank, 2-6 

iscntrl, 2-6 

isdigit, 2-6 

isfinite, 2-19 

isgraph, 2-6 

isgreater, 2-19 

isgreateregual, 2-19 

isinf, 2-19 

isless, 2-19 

islessequal, 2-19 

islessgreater, 2-19 

islower, 2-6 

isnan, 2-19 

isnormal, 2-19 

ISO C standard, 5-10 

isprint, 2-6 

ispunct, 2-6 

isspace, 2-6 

isunordered, 2-19 

isupper, 2-6 

iswalnum, 2-6, 2-46 

iswalpha, 2-6, 2-46 

iswblank, 2-6 

iswentrl, 2-6, 2-46 

iswctype, 2-46 

iswdigit, 2-6, 2-46 

iswgraph, 2-6, 2-46 

iswlower, 2-6, 2-47 

iswprint, 2-6, 2-47 

iswpunct, 2-6, 2-47 


Index-11 


Index-12 Index 


- 


iswspace, 2-6, 2-47 --misra-c-report, 5-136 
iswupper, 2-6, 2-47 —muncb, 5-137 
iswxdigit, 2-6 —-no-rescan, 5-139 
iswxditig, 2-47 no-rom-copy, 5-138 
isxdigit, 2-6 —-no-warnings, 5-150 


--non-romable, 5-141 
—-oplimize, 5-142 


L —-option-file, 5-121 
—-outpul, 5-144 
L_tmpnam, 2-23 —-strip-debug, 5-147 
110, 3-12 --user-provided-initialization-code, 
labs, 2-37 5-125 
language extensions, intrinsic --verbose, 5-149 
functions, 1-12 —-version, 5-148 
ldexp functions, 2-16 —warnings—as-errors, 5-152 
Idiv, 2-37 =c, 5-110 
len, 3-12 -D, 5-113 
lgamma functions, 2-18 -d, 5-114 
linker map file, 5-133 -e, 5-118 
linker options f; 5-121 
-?, 5-109 -l, 5-124 
—-case-insensilive, 5-112 “4, 5-125 
—-chip-output, 5-110 -k, 5-126 
—-define, 5-113 -L, 5-127 
--diag, 5-116 -l, 5-129 
--error-file, 5-120 -M, 5-133 
—-extern, 5-118 -m, 5-134 
—-exlra—verbose, 5-149 -N, 5-138 
first-library-first, 5-123 -O, 5-142 
—-help, 5-109 -o, 5-144 
ignore-defaull-library-patb, =r, 5-146 
5-127 -S, 5-147 
--include-directory, 5-124 -V, 5-148 
--incremental, 5-146 -v, 5-149 
keep-output-files, 5-126 Uy, 5-149 
--library, 5-129 -w, 5-150 
--library-directory, 5-127 linker script file 
--link-only, 5-130 architecture definition, 8-3 
—-Isl-check, 5-131 boad specification, 8-5 
--Isl-dump, 5-132 bus definition, 8-4 
--map-file, 5-133 derivative definition, 8-4 


--map-file-format, 5-134 memory definition, 8-4 


Index 


preprocessing, 8-6 
processor definition, 8-4 
section layout definition, 8-5 
structure, 8-3 
list, 3-75 
list file, 5-93 
assembler, 5-91 
linker, 5-133 
list on/off, 3-73 
llabs, 2-37 
lldiv, 2-37 
llrint functions, 2-15 
llround functions, 2-15 
Ing, 3-13 
lo, 3-13 
local, 3-45 
localeconv, 2-13 
localtime, 2-42 
log, 3-13 
log functions, 2-14 
log10 functions, 2-14 
log1p functions, 2-14 
log2 functions, 2-14 
logb functions, 2-14 
longjmp, 2-20 
los, 3-13 
Irint functions, 2-15 
Iround functions, 2-15 
Isb, 3-13 
Iseek, 2-44 
LSL expression evaluation, 8-20 
LSL functions 
absolute(), 8-9 
addressofQ, 8-9 
exists), 8-10 
max(), 8-10 
minO, 8-10 
sizeofQ, 8-10 
LSL keywords 
align, 8-23, 8-24, 8-25, 8-41 
alloc_allowed, 8-46 
allow_cross_references, 8-42 
architecture, 8-22, 8-30 


attributes, 8-40, 8-41 
bus, 8-23, 8-26, 8-35 
clustered, 8-42 
contiguous, 8-41 
copy_unit, 8-25 
copytable, 8-25, 8-48 
core, 8-30 

derivative, 8-29, 8-34 
dest, 8-25, 8-26 
dest_dbits, 8-27 
dest_offset, 8-26 
direction, 8-38, 8-41 
else, 8-49 

extends, 8-22, 8-29 
fill, 8-42, 8-46, 8-48 
fixed, 8-24, 8-45, 8-46 
group, 8-39, 8-40 
grows, 8-24 

heap, 8-24, 8-46 
high_to_low, 8-24, 8-38 
id, 8-23 

if, 8-49 

load_addr, 8-44 
low_to_high, 8-24, 8-38 
map, 8-23, 8-24, 8-26, 8-31 
mau, 8-23, 8-31, 8-35 
mem, 8-43 

memory, 8-31, 8-35 
min_size, 8-24, 8-45, 8-46 
nvoram, 8-31 

ordered, 8-41 

overlay, 8-42 

page, 8-45 

page_size, 8-24 
processor, 8-33 

ram, 8-31 

reserved, 8-31, 8-46 
rom, 8-31 

run_addr, 8-25, 8-43 
section, 8-47 

section _layoul, 8-38 
select, 8-39 


Index-13 


Index-14 


- 


size, 8-26, 8-31, 8-35, 8-45, 8-46, 
8-47 

space, 8-23, 8-26 
speed, 8-31, 8-35 
src_dbits, 8-27 
src_offset, 8-26 
slack, 8-24, 8-45 
start_address, 8-25 
symbol, 8-25 
type, 8-31, 8-35 
width, 8-23 

LSL syntax, 8-6 

Ist, 3-14 

lun, 3-14 


mac, 3-14 
macro, 3—46 

define, 5-160 

definition, 3-46 

undefine, 3-51, 5-206 
macro/nomacro, 1-28 
macros, 1-31 

make utility, 5-214 
macros, predefined 

__DATE_, 5-58 

_ FILE_., 5-58 

__LINE_, 5-58 

_ STDC _, 5-58 

__TIME_, 5-58 
Magnitude, 2-5 
make utility options 

-?, 5-216 

-d, 5-217 

-c, 5-218 

-D, 5-219 

-d, 5-220 

-DD, 5-219 

-dd, 5-220 

-e, 5-221 


-err, 5-222 

Sf, 5-223 

-G, 5-224 

-t, 5-225 

-K, 5-226 

-k, 5-227 

-m, 5-228, 5-234 

-n, 5-230 

—p, 5-231 

-g, 5-232 

=r, 5-233 

=s, 5-235 

-t, 5-236 

-time, 5-237 

-V, 5-238 

-W, 5-239 

—w, 5-240 

-x, 5-241 

defining a macro, 5-214 
malloc, 2-35 
map file 

control program option, 5-194 

format, 5-134 

linker, 5-133 
mappings, 8-26 
max, 3-14 
MB CUR MAX, 2-34, 2-45 
MB LEN MAX, 2-45 
mblen, 2-37 
mbrlen, 2-46 
mbrtowc, 2-45 
mbsinit, 2-45 
mbsrtowcs, 2-45 
mbstate_t, 2-45 
mbstowcs, 2-37 
mbtowc, 2-37 
memchr, 2-40 
memcmp, 2-39 
memcpy, 2-38 
memmove, 2-38 
memory definition, 8-4 


Index 


Index 


memory management instructions, 
5-95, 5-190 

memset, 2-41 

message, 1-28, 3-48 

min, 3-14 

min/max of integers, 1-13 

MISRA-C, 5-36, 5-37 
supported rules 1998, 10-3 
supported rules 2004, 10-10 
version, 5-38 

mktime, 2—42 

fpu, 3-70 

mmu, 3-77 

modf functions, 2-16 

Modulus, 2-5 

msb, 3-15 

mxp, 3-15 


nan functions, 2-17 
nearbyint functions, 2-15 
nextafter functions, 2-17 
nexttoward functions, 2-17 
Norm, 2—5 

NULL, 2-22 


O 


object, 3—78 

object comment, 1-29 

offsetof, 2-22 

open, 2-9 

optimization, 5-43, 5-97, 5-142 

optimize/endoptimize, 1-29 

option file, 5-21, 5-80, 5-121, 5-168, 
5-228 

org, 3-49 

output file, 5-46, 5-98, 5-144, 5-197 

output format, 5-110, 5-174 


P 


pack, 1-29 
packed data type support, 1-15 
page, 3-79 
pass option to tool, 5-210 
perror, 2-33 
Phase angle, 2-5 
pmacro, 3-51 
pmi_tc, 3-68 
pmu tc, 3-68 
pos, 3-15 
pow, 3-15 
pow functions, 2-17 
power-on vector, 4-3 
Pragma 
extern, 1-27 
indirect, 1-28 
indirect_runtime, 1-28 
macro, 1-28 
message, 1-28 
object_comment, 1-29 
tradeoff, 1-30 
warning, 1-30 
weak, 1-30 
Pragmas 
alias, 1-26, 1-30 
align, 1-26 
clear/noclear, 1-27 
default_a0_size, 1-27 
default_a1_size, 1-27 
default_near_size, 1-27 
extension isuffix, 1-27 
for_constant_data_use_memory, 
1-28 
for_extern_data_use_memory, 1-28 
for_initialized_data_use_memory, 
1-28 
for_uninitialized_data_use_memory, 
1-28 
inline/noinline, 1-28 
optimize/endoptimize, 1-29 


Index-15 


Index-16 


- 


pack, 1-29 
section, 1-29 
section all, 1-29 
seclion code_init, 1-29 
section const_init, 1-29 
section data_overlay, 1-29 
section vector_init, 1-29 
smartinline, 1-28 
source/nosource, 1-29 
pragmas, 1-26 
pretl, 3-81 
predefined macros, 1-31 
predefined macros in C 


_CTC_,1-31 
_ DOUBLE FP_, 1-31 

_ DSPC__, 1-31 

_ DSPC VERSION _, 1-31 
__FPU_, 1-31 


__SINGLE_FP_, 1-31 
__TASKING _, 1-31 
preprocessing, 8-6 
preprocessor, 5-94 
printf, 2-25, 2-31 
conversion characters, 2-27 
processor definition, 8-4, 8-33 
ptrdiff_t, 2-22 
putc, 2-30 
putchar, 2-30 
puts, 2-31 
putwc, 2-30 
putwchar, 2-30 


gsort, 2-36 


raise, 2-20 
rand, 2-35 
RAND MAX, 2-34 


Index 


read, 2-44 

realloc, 2-35 
reentrancy, 2—48 
register handling, 1-22 
remainder functions, 2-16 
remove, 2-33 

remguo functions, 2-16 
rename, 2-33 

rename sections, 5—48 
reset vector, 8-25 
rewind, 2-32 

Riemann sphere, 2-6 
rint functions, 2-15 
rnd, 3-15 

round functions, 2-15 
rvb, 3-16 


S 


scalbln functions, 2-16 
scalbn functions, 2-16 
scanf, 2-27, 2-30 

conversion characters, 2-28 
scp, 3-16 
sdecl, 3-52 
sect, 3-55 
section, 1-29 

summary, 5-101 
section activation, 3-55 
section all, 1-29 
section attributes, 3-52 
section code_init, 1-29 
section data_overlay, 1-29 
section declaration, 3-52 
section layout definition, 8-5, 8-37 
section names, 3-53 
sections 

grouping, 8-39 

rename, 5-48 
SEEK_CUR, 2-32 
SEEK END, 2-32 
SEEK SET, 2-32 


Index 


set, 3-56 

setbuf, 2-25 

setjmp, 2-20 

setlocale, 2-12 

setvbuf, 2-25 

sfract, 3-16, 3—40 

sgn, 3-16 

SIGABRT, 2-20 

SIGFPE, 2-20 

SIGFPE signal handler, 4-14 

SIGILL, 2-20 

SIGINT, 2-20 

signal, 2-20 

signbit, 2-19 

SIGSEGV, 2-20 

SIGTERM, 2-20 

silicon bug workaround, 5-52, 5-99, 
5-202 

sin, 3-16 

sin functions, 2-13 

sinh functions, 2-13 

size, 3-57 

size_t, 2-22 

smartinline, 1-28 

snh, 3-17 

snprintf, 2-31 

source/nosource, 1-29 

space, 3-58 

sprintf, 2-31 

sgrt functions, 2-17 

sqt, 3-17 

srand, 2-35 

sscanf, 2-30 

stack, 4-9, 8-24 

begin of, 4-9 

start address, 8-25 

startup code, 4-3 

stat, 2-44 

stderr, 2-23 

stdin, 2-23 

stdout, 2-23 

stitle, 3-82 

strcat, 2-38 


strchr, 2-40 

strcmp, 2-39 

strcoll, 2-39 

strcpy, 2-38 

strespn, 2—40 

strerror, 2—41 

strftime, 2-43 

strncat, 2-38 

strncmp, 2-39 

strncpy, 2-38 

strpbrk, 2—40 

strrchr, 2—40 

strspn, 2—40 

strstr, 2-40 

strtod, 2-34 

strtof, 2-34 

strtoimax, 2-11 

strtok, 2—40 

strtol, 2-35 

strtold, 2-34 

strtoll, 2-35 

strtoul, 2-35 

strtoull, 2-35 

strtoumax, 2-11 

strxfrm, 2-39 

sub, 3-17 

switch auto, 1-30 

switch jumptab, 1-30 

switch linear, 1-30 

switch lookup, 1-30 

switch restore, 1-30 

switch statement, 5—55 

swprintf, 2-31 

swscanf, 2-30 

syntax error checking, 5-11, 5-73, 
5-159 

system, 2-36 

system libraries, 5-127, 5-129 


Index-17 


Index-18 Index 


= 
T Vv 


tan, 3-17 va arg, 2-21 

tan functions, 2-13 va_end, 2-21 

tanh functions, 2-13 va_start, 2-21 

tc2, 3-83 verbose, 5-149, 5-209 


version information, 5-60, 5-103, 
5-148, 5-208, 5-238, 5-239, 5-250 


temporary files, 5-205 
tgamma functions, 2-18 


time, 2-42 

time_t, 2-41 

tm (struct), 2-41 
TMP_MAX, 2-23 
tmpfile, 2-33 
tmpnam, 2-33 

tnh, 3-17 

tolower, 2-7 
toupper, 2-7 
towctrans, 2—47 
towlower, 2-7, 2-47 
towupper, 2-7, 2-47 
tradeoff, 1-30 

trap, 4-18 

trap handler, 4-14 
trap handling, 5-175 
trap handling api, 4-15 


vfprintf, 2-31 
vfscanf, 2-30 
vfwprintf, 2-31 
vfwscanf, 2-30 
vprintf, 2-31 
vscanf, 2-30 
vsprintf, 2-31 
vsscanf, 2-30 
vswprintf, 2-31 
vswscanf, 2-30 
vwprintf, 2-31 
vwscanf, 2-30 


Ww 


warning, 1-30, 3-61 


TriCore 2 instructions, 5-34, 5-89, title, 3-84, 3-85 
5-183 warnings, 5-212 
trunc functions, 2-15 suppress, 5-104 
type, 3-59 warnings as errors, 5-63, 5-106, 5-152 
warnings, suppress, 5-61, 5-150 
wchar_t, 2-22 


U wcrtomb, 2-46 


wcscat, 2-38 


undef, 3-60 weschr, 2-40 

unf, 3-18 wescmp, 2-39 
ungetc, 2-29 wcscoll, 2-39 
ungetwc, 2-29 wcscpy, 2-38 


unlink, 2-44 wcscspn, 2-40 


Index 


wcsncat, 2-38 
wcsncmp, 2-39 
wcsncpy, 2-38 
wcspbrk, 2-40 
wcsrchr, 2-40 
wcsrtombs, 2—45 
wcsspn, 2-40 
wcsstr, 2—40 
wcstod, 2-34 
wcstof, 2-34 
wcstoimax, 2-11 
wcstok, 2-40 
wcstol, 2-35 
wcstold, 2-34 
wcstoll, 2-35 
wcstombs, 2-37 
wcstoul, 2-35 
wcstoull, 2-35 
wcstoumax, 2-11 
wcsxfrm, 2-39 
wctob, 2-46 


wctomb, 2-37 
wctrans, 2—47 
wctype, 2-46 
weak, 1-30, 3-62 
WEOF, 2-23 
wmemchr, 2-40 
wmemcmp, 2-39 
wmemcpy, 2-38 
wmemmove, 2-38 
wmemset, 2-41 
word, 3-63 
wprintf, 2-31 
write, 2-44 
wscanf, 2-30 
wstrftime, 2—43 


X 


xpn, 3-18 


Index-19 


Index-20 


INDEX 


Index 


